# Ruchy Programming Language
[](https://opensource.org/licenses/MIT)
[](https://www.rust-lang.org)
[](https://crates.io/crates/ruchy)
[](https://github.com/noahgift/ruchy)
A modern, expressive programming language for data science and scientific computing, featuring a self-hosting compiler, comprehensive tooling, and enterprise-grade quality standards.
## Features
- **Self-Hosting Compiler**: Written in Rust with full bootstrapping capabilities
- **Interactive REPL**: Advanced REPL with syntax highlighting and completion
- **WebAssembly Support**: Compile to WASM for browser and edge deployment
- **Notebook Integration**: Jupyter-style notebooks with testing framework
- **Type System**: Bidirectional type checking with inference
- **Actor Model**: Built-in concurrency with supervision trees
- **Quality First**: Toyota Way principles with PMAT A+ code standards
## Installation
```bash
# Install from crates.io
cargo install ruchy
# Or build from source
git clone https://github.com/noahgift/ruchy
cd ruchy
cargo build --release
```
## Quick Start
```bash
# Start the interactive REPL
ruchy repl
# Run a Ruchy script
ruchy run script.ruchy
# Format code
ruchy fmt src/
# Run tests
ruchy test run tests/
```
## Language Examples
### Basic Syntax
```ruchy
// Variables and functions
let x = 42
let add = fn(a, b) => a + b
// Pattern matching
match value {
Some(x) => println(f"Got {x}"),
None => println("Nothing"),
}
// Async/await with blocks and lambdas (NEW in v3.45.0)
async fn fetch_data(url) {
let response = await http.get(url)
response.json()
}
// Async blocks
let future_result = async {
let data = await fetch_data("api/users")
data.length
}
// Async lambdas
```
### Actor System (NEW in v3.46.0)
```ruchy
// Define actors with state and message handlers
actor ChatAgent {
name: String,
message_count: i32,
receive process_message(content: String, sender: String) {
self.message_count = self.message_count + 1;
println("[" + self.name + "] From " + sender + ": " + content)
}
receive get_stats() -> String {
self.name + " processed " + self.message_count.to_string() + " messages"
}
}
actor BankAccount {
balance: i32,
account_number: String,
receive deposit(amount: i32) {
self.balance = self.balance + amount;
println("Deposited " + amount.to_string() + ". Balance: " + self.balance.to_string())
}
receive withdraw(amount: i32) {
if amount <= self.balance {
self.balance = self.balance - amount;
println("Withdrew " + amount.to_string() + ". Balance: " + self.balance.to_string())
}
}
receive get_balance() -> i32 {
self.balance
}
}
```
### Data Science Features
```ruchy
// DataFrame operations
let df = read_csv("data.csv")
let result = df
|> filter(row => row.age > 18)
|> group_by("category")
|> agg(mean("value"))
|> sort_by("mean_value", descending=true)
// Plotting
plot(df.x, df.y, kind="scatter", title="Analysis")
```
## CLI Commands
### Core Commands
- `ruchy repl` - Start interactive REPL
- `ruchy run <file>` - Execute a Ruchy script
- `ruchy fmt <path>` - Format code (supports --check flag)
### WebAssembly
- `ruchy wasm compile <input> -o <output>` - Compile to WASM
- `ruchy wasm validate <module>` - Validate WASM module
- `ruchy wasm run <module>` - Execute WASM module
### Notebook
- `ruchy notebook serve` - Start notebook server
- `ruchy notebook test <file>` - Test notebook with coverage
- `ruchy notebook convert <input> <output>` - Convert notebook format
### Testing
- `ruchy test run <path>` - Run tests with optional coverage
- `ruchy test report` - Generate test report (HTML/JSON/JUnit)
## Project Structure
```
ruchy/
├── src/
│ ├── frontend/ # Parser and AST
│ ├── middleend/ # Type system and inference
│ ├── backend/ # Code generation and transpilation
│ ├── runtime/ # REPL and interpreter
│ ├── lsp/ # Language server protocol
│ └── wasm/ # WebAssembly support
├── tests/ # Integration tests
├── examples/ # Example programs
└── docs/ # Documentation
```
## Quality Standards
This project follows strict quality engineering practices:
- **Test Coverage**: 46.41% line coverage, 50.79% branch coverage
- **Complexity Limits**: All functions ≤10 cyclomatic complexity
- **Zero Technical Debt**: No TODO/FIXME comments allowed
- **PMAT A+ Grade**: Enforced via automated quality gates
- **TDD Practice**: Test-first development methodology
## Development
### Basic Development Commands
```bash
# Run tests
make test
# Check coverage
make coverage
# Run quality checks
make lint
# Build documentation
make doc
```
### WebAssembly QA Framework
The project includes a comprehensive WebAssembly Quality Assurance Framework v3.0 with 4 validation phases:
```bash
# Run complete QA validation
make qa-framework
# Individual phases
make qa-foundation # Coverage & infrastructure
make qa-browser # Browser testing & WASM validation
make qa-quality # Security & complexity analysis
make qa-optimization # Performance & regression testing
# Quick quality checks
make qa-security # Security analysis
make qa-complexity # Complexity analysis
make qa-dashboard # Interactive quality dashboard
# See all QA commands
make qa-help
```
**Quality Targets:**
- 90% branch coverage
- ≤10 cyclomatic complexity per function
- Zero security vulnerabilities
- <500KB optimized WASM binaries
- <5% performance regression tolerance
## Documentation
- [Language Specification](docs/SPECIFICATION.md)
- [Development Roadmap](docs/execution/roadmap.md)
- [Contributing Guide](CONTRIBUTING.md)
- [Architecture Overview](docs/architecture/README.md)
## Contributing
We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details on our code of conduct and development process.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Acknowledgments
- Built with Rust and the incredible Rust ecosystem
- Inspired by Python's expressiveness and Rust's safety
- Quality practices from Toyota Way and PMAT methodologies
## Contact
- **Author**: Noah Gift
- **Repository**: [github.com/noahgift/ruchy](https://github.com/noahgift/ruchy)
- **Issues**: [GitHub Issues](https://github.com/noahgift/ruchy/issues)