508 lines
12 KiB
Markdown
508 lines
12 KiB
Markdown
# 🚀 OverCode - The Ultimate Polyglot Programming Environment
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**OverCode** is the next evolution of polyglot programming! Based on m5rcode but with **INSANE** enhancements including:
|
|
- 🎮 **12+ Built-in Games** (Snake, Tetris, 2048, Adventure, etc.)
|
|
- 🌈 **5 Beautiful Themes** (Cyberpunk, Matrix, Ocean, Sunset, Hacker)
|
|
- 💻 **20+ Programming Languages** (Python, JS, Go, Rust, Java, PHP, etc.)
|
|
- 🛠️ **Developer Tools** (Formatter, Debugger, Profiler)
|
|
- 📦 **Package Manager** for extensions
|
|
- 🎨 **ASCII Art Generator**
|
|
- 🔒 **Security Tools** (Encryption, Hashing)
|
|
- 🤖 **AI/ML Templates**
|
|
- 🌐 **Web Development Stack**
|
|
|
|
---
|
|
|
|
## ✨ What Makes OverCode EPIC?
|
|
|
|
### 🎮 Gaming Center
|
|
Transform your coding session into an entertainment experience!
|
|
|
|
```bash
|
|
game snake # Classic Snake game
|
|
game tetris # Epic Tetris with ASCII blocks
|
|
game 2048 # Number puzzle game
|
|
game adventure # Text-based RPG in programming world
|
|
game mines # Minesweeper with digital mines
|
|
game quiz # Programming knowledge quiz
|
|
```
|
|
|
|
### 🌈 Theme System
|
|
Your shell, your style!
|
|
|
|
```bash
|
|
theme cyberpunk # Neon purple/cyan vibes
|
|
theme matrix # Green-on-black hacker aesthetic
|
|
theme ocean # Calming blue gradients
|
|
theme sunset # Warm orange/pink colors
|
|
theme hacker # Terminal green with dark accents
|
|
```
|
|
|
|
### 💻 Multi-Language Support
|
|
Write in 20+ languages in one file!
|
|
|
|
```overcode
|
|
<?py
|
|
print("🐍 Python is awesome!")
|
|
?>
|
|
|
|
<?js
|
|
console.log("🟨 JavaScript rocks!");
|
|
?>
|
|
|
|
<?go
|
|
fmt.Println("🐹 Go is fast!")
|
|
?>
|
|
|
|
<?rs
|
|
println!("🦀 Rust is safe!");
|
|
?>
|
|
|
|
<?java
|
|
System.out.println("☕ Java runs everywhere!");
|
|
?>
|
|
```
|
|
|
|
---
|
|
|
|
## 🚀 Quick Start
|
|
|
|
### Installation
|
|
|
|
1. **Clone the repository:**
|
|
```bash
|
|
git clone https://github.com/yourusername/overcode.git
|
|
cd overcode
|
|
```
|
|
|
|
2. **Install dependencies:**
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
3. **Launch OverCode:**
|
|
```bash
|
|
python overshell.py
|
|
```
|
|
|
|
### Your First OverCode Experience
|
|
|
|
```bash
|
|
# Create a hello world file
|
|
new hello.ovc:hello
|
|
|
|
# Run it and see magic happen
|
|
run hello.ovc
|
|
|
|
# Play some games!
|
|
game
|
|
|
|
# Change the theme
|
|
theme matrix
|
|
|
|
# View awesome help system
|
|
help
|
|
```
|
|
|
|
---
|
|
|
|
## 📚 Feature Showcase
|
|
|
|
### 🎯 File Templates
|
|
|
|
Create files with pre-built templates:
|
|
|
|
```bash
|
|
new demo.ovc:games # Gaming showcase
|
|
new ai.ovc:ai # Machine learning examples
|
|
new web.ovc:web # Full-stack web development
|
|
new security.ovc:crypto # Cryptography and security
|
|
```
|
|
|
|
### 🎮 Built-in Games
|
|
|
|
| Game | Description | Command |
|
|
|------|-------------|---------|
|
|
| 🐍 Snake | Classic snake with emoji graphics | `game snake` |
|
|
| 🟦 Tetris | Block-stacking puzzle | `game tetris` |
|
|
| 🔢 2048 | Number combination puzzle | `game 2048` |
|
|
| 🧬 Game of Life | Cellular automaton simulation | `game life` |
|
|
| ⚔️ Text Adventure | Programming-themed RPG | `game adventure` |
|
|
| 💣 Minesweeper | Mine detection game | `game mines` |
|
|
| 🏓 Pong | Classic arcade tennis | `game pong` |
|
|
| 🧠 Memory | Symbol matching game | `game memory` |
|
|
| 🎪 Hangman | Programming word guessing | `game hangman` |
|
|
| ✂️ Rock Paper Scissors | vs AI opponent | `game rps` |
|
|
| 🤔 Programming Quiz | Test your coding knowledge | `game quiz` |
|
|
|
|
### 🛠️ Developer Tools
|
|
|
|
```bash
|
|
format code.ovc # Format and beautify code
|
|
debug script.ovc # Interactive debugger
|
|
benchmark test.ovc # Performance testing
|
|
stats # Session statistics
|
|
encrypt file.txt # File encryption tools
|
|
```
|
|
|
|
### 🌈 Available Themes
|
|
|
|
| Theme | Description | Colors |
|
|
|-------|-------------|--------|
|
|
| 🔮 Cyberpunk | Neon-futuristic | Purple, Cyan, Green |
|
|
| 🖥️ Matrix | Hacker aesthetic | Green variations |
|
|
| 🌊 Ocean | Calming blues | Blue, Cyan, Light Blue |
|
|
| 🌅 Sunset | Warm colors | Yellow, Red, Magenta |
|
|
| 💚 Hacker | Terminal vibes | Black, Green, Light Green |
|
|
|
|
---
|
|
|
|
## 🎨 Language Support
|
|
|
|
OverCode supports **20+ programming languages** with automatic execution:
|
|
|
|
### Compiled Languages
|
|
- **C/C++** - System programming powerhouses
|
|
- **Rust** - Memory-safe systems programming
|
|
- **Go** - Concurrent and efficient
|
|
- **Java** - Write once, run anywhere
|
|
- **C#** - Microsoft's versatile language
|
|
- **Kotlin** - Modern JVM language
|
|
- **Swift** - Apple's powerful language
|
|
|
|
### Interpreted Languages
|
|
- **Python** - The swiss army knife
|
|
- **JavaScript** - Web and beyond
|
|
- **TypeScript** - Typed JavaScript
|
|
- **PHP** - Web development classic
|
|
- **Ruby** - Programmer happiness
|
|
- **Lua** - Lightweight scripting
|
|
- **Perl** - Text processing master
|
|
- **R** - Statistical computing
|
|
- **Julia** - High-performance scientific
|
|
|
|
### Scripting & Shell
|
|
- **Bash** - Unix shell scripting
|
|
- **PowerShell** - Windows automation
|
|
- **Dart** - Flutter and web development
|
|
|
|
---
|
|
|
|
## 💡 Example Code
|
|
|
|
### 🎮 Gaming Example
|
|
```overcode
|
|
<?py
|
|
# Snake Game Logic
|
|
import random
|
|
|
|
class SnakeGame:
|
|
def __init__(self):
|
|
self.score = 0
|
|
self.snake = [(10, 10)]
|
|
self.food = (5, 5)
|
|
|
|
def move(self, direction):
|
|
print(f"Snake moving {direction}! Score: {self.score}")
|
|
|
|
game = SnakeGame()
|
|
game.move("right")
|
|
?>
|
|
|
|
<?js
|
|
// Game UI with JavaScript
|
|
class GameUI {
|
|
constructor() {
|
|
this.canvas = "ASCII Canvas";
|
|
}
|
|
|
|
render(gameState) {
|
|
console.log("🎮 Rendering game...");
|
|
console.log(`Score: ${gameState || 0}`);
|
|
}
|
|
}
|
|
|
|
const ui = new GameUI();
|
|
ui.render(100);
|
|
?>
|
|
```
|
|
|
|
### 🤖 AI/ML Example
|
|
```overcode
|
|
<?py
|
|
# Neural Network
|
|
import random
|
|
|
|
class Neuron:
|
|
def __init__(self):
|
|
self.weights = [random.random() for _ in range(3)]
|
|
|
|
def predict(self, inputs):
|
|
return sum(w * i for w, i in zip(self.weights, inputs))
|
|
|
|
neuron = Neuron()
|
|
result = neuron.predict([1, 0.5, 0.8])
|
|
print(f"🧠 Neural output: {result:.3f}")
|
|
?>
|
|
|
|
<?js
|
|
// AI Data Processing
|
|
const data = [1, 2, 3, 4, 5];
|
|
const processed = data.map(x => x * x);
|
|
console.log("📊 Processed data:", processed);
|
|
|
|
// Simple ML Algorithm
|
|
function linearRegression(x, y) {
|
|
const n = x.length;
|
|
const sumX = x.reduce((a, b) => a + b, 0);
|
|
const sumY = y.reduce((a, b) => a + b, 0);
|
|
|
|
console.log(`📈 Training on ${n} samples`);
|
|
return { slope: sumY / sumX, intercept: 0 };
|
|
}
|
|
|
|
const model = linearRegression([1, 2, 3], [2, 4, 6]);
|
|
console.log("🎯 Model trained:", model);
|
|
?>
|
|
```
|
|
|
|
### 🌐 Web Development Example
|
|
```overcode
|
|
<?py
|
|
# Python Backend API
|
|
from datetime import datetime
|
|
import json
|
|
|
|
def create_user_api():
|
|
users = [
|
|
{"id": 1, "name": "Alice", "role": "developer"},
|
|
{"id": 2, "name": "Bob", "role": "designer"}
|
|
]
|
|
|
|
response = {
|
|
"status": "success",
|
|
"data": users,
|
|
"timestamp": datetime.now().isoformat()
|
|
}
|
|
|
|
print("🌐 API Response:")
|
|
print(json.dumps(response, indent=2))
|
|
|
|
create_user_api()
|
|
?>
|
|
|
|
<?js
|
|
// Frontend JavaScript
|
|
class UserInterface {
|
|
constructor() {
|
|
this.users = [];
|
|
}
|
|
|
|
async loadUsers() {
|
|
console.log("📡 Loading users from API...");
|
|
// Simulate API call
|
|
this.users = [
|
|
{ name: "Alice", avatar: "👩💻" },
|
|
{ name: "Bob", avatar: "👨🎨" }
|
|
];
|
|
this.render();
|
|
}
|
|
|
|
render() {
|
|
console.log("🎨 Rendering UI:");
|
|
this.users.forEach(user => {
|
|
console.log(`${user.avatar} ${user.name}`);
|
|
});
|
|
}
|
|
}
|
|
|
|
const ui = new UserInterface();
|
|
ui.loadUsers();
|
|
?>
|
|
|
|
<?php
|
|
// PHP Server Logic
|
|
class DatabaseManager {
|
|
private $users = [
|
|
["email" => "alice@overcode.dev", "active" => true],
|
|
["email" => "bob@overcode.dev", "active" => false]
|
|
];
|
|
|
|
public function getActiveUsers() {
|
|
$active = array_filter($this->users, function($user) {
|
|
return $user['active'];
|
|
});
|
|
|
|
echo "🐘 Active users from PHP:\n";
|
|
foreach ($active as $user) {
|
|
echo "- " . $user['email'] . "\n";
|
|
}
|
|
}
|
|
}
|
|
|
|
$db = new DatabaseManager();
|
|
$db->getActiveUsers();
|
|
?>
|
|
```
|
|
|
|
---
|
|
|
|
## 🎯 Advanced Features
|
|
|
|
### 📦 Package System (Coming Soon)
|
|
```bash
|
|
package install game-engine # Install gaming extensions
|
|
package install ai-tools # ML/AI utilities
|
|
package install web-framework # Web development tools
|
|
package list # Show installed packages
|
|
package update # Update all packages
|
|
```
|
|
|
|
### 🔒 Security Tools
|
|
```bash
|
|
encrypt myfile.txt # Encrypt files
|
|
hash document.pdf # Generate file hashes
|
|
secure-delete sensitive.doc # Secure file deletion
|
|
```
|
|
|
|
### 📊 Data Visualization
|
|
```bash
|
|
plot data.csv # Generate ASCII graphs
|
|
table users.json # Display data tables
|
|
export results.xlsx # Export to various formats
|
|
```
|
|
|
|
---
|
|
|
|
## 🎨 Customization
|
|
|
|
### Creating Custom Themes
|
|
```json
|
|
{
|
|
"name": "my-theme",
|
|
"colors": {
|
|
"primary": "#ff6b6b",
|
|
"secondary": "#4ecdc4",
|
|
"accent": "#45b7d1",
|
|
"error": "#ff5252",
|
|
"warning": "#ffc107",
|
|
"info": "#2196f3",
|
|
"text": "#ffffff"
|
|
}
|
|
}
|
|
```
|
|
|
|
### Adding Custom Commands
|
|
```python
|
|
class CustomCommand:
|
|
def __init__(self, args):
|
|
self.args = args
|
|
|
|
def run(self):
|
|
print("🔧 Running custom command!")
|
|
# Your custom logic here
|
|
```
|
|
|
|
---
|
|
|
|
## 🤝 Contributing
|
|
|
|
We'd love your help making OverCode even more EPIC!
|
|
|
|
1. **Fork the repository**
|
|
2. **Create your feature branch** (`git checkout -b feature/AmazingFeature`)
|
|
3. **Add your epic code** (games, languages, themes, tools!)
|
|
4. **Commit your changes** (`git commit -m 'Add AmazingFeature'`)
|
|
5. **Push to the branch** (`git push origin feature/AmazingFeature`)
|
|
6. **Open a Pull Request**
|
|
|
|
### Ideas for Contributions
|
|
- 🎮 **New Games** - Breakout, Space Invaders, Chess
|
|
- 🌈 **New Themes** - Dracula, Nord, Monokai
|
|
- 💻 **Language Support** - Zig, V, Crystal
|
|
- 🛠️ **Developer Tools** - Linter, Profiler, Formatter
|
|
- 📱 **Mobile Support** - Android/iOS compatibility
|
|
|
|
---
|
|
|
|
## 📋 Requirements
|
|
|
|
```
|
|
Python 3.8+
|
|
colorama>=0.4.4
|
|
pyfiglet>=0.8.post1
|
|
pypresence>=4.2.1 (optional, for Discord RPC)
|
|
requests>=2.25.1
|
|
```
|
|
|
|
### Optional Dependencies
|
|
```bash
|
|
# For full language support
|
|
node.js # JavaScript/TypeScript
|
|
go # Go language
|
|
rustc # Rust compiler
|
|
gcc/g++ # C/C++
|
|
java/javac # Java
|
|
php # PHP
|
|
ruby # Ruby
|
|
```
|
|
|
|
---
|
|
|
|
## 🔮 Roadmap
|
|
|
|
### Version 2.1 - "Performance Beast"
|
|
- [ ] 🚀 **JIT Compilation** for faster execution
|
|
- [ ] 📊 **Real-time Performance Monitoring**
|
|
- [ ] 🔧 **Advanced Debugging Tools**
|
|
- [ ] 📱 **Mobile App** (React Native)
|
|
|
|
### Version 2.2 - "AI Revolution"
|
|
- [ ] 🤖 **AI Code Assistant** (ChatGPT integration)
|
|
- [ ] 🧠 **Smart Autocomplete**
|
|
- [ ] 🔍 **Intelligent Error Detection**
|
|
- [ ] 📚 **AI-powered Documentation**
|
|
|
|
### Version 2.3 - "Cloud Connected"
|
|
- [ ] ☁️ **Cloud Sync** for settings/files
|
|
- [ ] 🌐 **Online Code Sharing**
|
|
- [ ] 👥 **Collaborative Coding**
|
|
- [ ] 📈 **Analytics Dashboard**
|
|
|
|
---
|
|
|
|
## 🏆 Credits & Inspiration
|
|
|
|
**OverCode** is built with ❤️ by:
|
|
- **Original Concept:** Based on [m5rcode](https://github.com/m4rcel-lol/m5rcode)
|
|
- **Enhanced by:** The OverCode development team
|
|
- **Special Thanks:** The entire programming community
|
|
|
|
### Built With
|
|
- **Python** - Core shell and interpreter
|
|
- **Colorama** - Cross-platform colored terminal text
|
|
- **Pyfiglet** - ASCII art text generation
|
|
- **Love & Coffee** - The secret ingredients ☕
|
|
|
|
---
|
|
|
|
## 📜 License
|
|
|
|
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
|
|
|
---
|
|
|
|
## 🌟 Star This Project!
|
|
|
|
If OverCode made your coding experience more EPIC, please give us a ⭐!
|
|
|
|
**Happy Coding! 🚀💻✨**
|
|
|
|
---
|
|
|
|
*Made with 💜 by developers, for developers* |