How sina-salahshour/mahlang works
Mah is a programming language toolchain: users compile or run source through the mah CLI, which preprocesses modules, compiles and type-checks them, and emits portable .mahc bytecode or executes it. That bytecode is the boundary shared by the Python and Rust VMs. Separate tooling provides formatting, project setup, and LSP features; the README also documents a standard library and editor integrations. Some subsystem links below are documented rather than source-verified because their implementation files were not sampled.
Main entry points: main.py Mah CLI · analysis.py Language analysis · lower.py Bytecode lowering · code_interpreter.py Python VM
Components 25
Language frontend
- Module preprocessor
mah/preprocessor.py - Lexer
mah/compiler/lexer.py - Parser
mah/compiler/parser.py - AST model
mah/compiler/ast_nodes.py - Resolver
mah/compiler/resolve.py - Type checker
mah/compiler/typecheck.py - Code generator
mah/compiler/codegen.py
Bytecode
- Bytecode lowering
mah/bytecode/lower.py - Bytecode format
mah/bytecode/format.py - Program model
mah/bytecode/program.py - Bytecode decoder
mah/bytecode/decode.py
Execution runtimes
- Python VM
mah/code_interpreter.py - Runtime values
mah/runtime_values.py - Native functions
mah/natives.py - Rust VM
runtime/src/vm/exec.rs - Rust decoder
runtime/src/decode.rs
Developer tooling
- Source formatter
mah/format/formatter.py - Language server
mah/lsp/server.py - Language analysis
mah/lsp/analysis.py - VS Code extension
editors/vscode/src/extension.ts
Project support
- Mah CLI
mah/cli/main.py - Project manifest
mah/project/manifest.py - Project initializer
mah/project/init.py
Other components
- Language user
- Editor user
Connections 36
- Language user → Mah CLI: runs commands
- Mah CLI → Module preprocessor: compiles source
mah/cli/main.py - Module preprocessor → Lexer: prepares source
mah/preprocessor.py - Lexer → Parser: produces tokens
mah/compiler/parser.py - Parser → AST model: produces AST
mah/compiler/parser.py - Resolver → AST model: walks AST
mah/compiler/resolve.py - Mah CLI → Resolver: compiles source
mah/cli/main.py - Mah CLI → Type checker: checks types
mah/cli/main.py - Type checker → AST model: checks AST
mah/compiler/typecheck.py - Mah CLI → Code generator: generates code
mah/cli/main.py - Code generator → AST model: reads AST
mah/compiler/codegen.py - Code generator → Bytecode lowering: lowers code
mah/bytecode/lower.py - Bytecode lowering → Module preprocessor: uses module data
mah/bytecode/lower.py - Bytecode lowering → Bytecode format: uses opcodes
mah/bytecode/lower.py - Bytecode lowering → Program model: builds program
mah/bytecode/lower.py - Mah CLI → Python VM: runs bytecode
mah/cli/main.py - Mah CLI → Rust VM: runs bytecode
- Python VM → Bytecode decoder: decodes bytecode
mah/code_interpreter.py - Bytecode decoder → Bytecode format: reads format
mah/bytecode/decode.py - Bytecode decoder → Program model: creates program
mah/bytecode/decode.py - Python VM → Runtime values: uses values
mah/code_interpreter.py - Python VM → Native functions: links natives
mah/code_interpreter.py - Rust VM → Rust decoder: executes decoded code
runtime/src/vm/exec.rs - Rust decoder → Rust VM: links bytecode
runtime/src/decode.rs - Mah CLI → Source formatter: formats source
- Mah CLI → Language server: starts server
mah/cli/main.py - Language server → Language analysis: requests analysis
mah/lsp/server.py - Language analysis → Parser: uses parser
mah/lsp/analysis.py - Language analysis → Resolver: uses resolver
mah/lsp/analysis.py - Language analysis → Type checker: uses checker
mah/lsp/analysis.py - Language analysis → Source formatter: uses formatter
mah/lsp/analysis.py - Mah CLI → Project manifest: loads project
mah/project/manifest.py - Mah CLI → Project initializer: initializes project
mah/cli/main.py - Project initializer → Project manifest: creates manifest
mah/project/init.py - Editor user → VS Code extension: uses editor
- VS Code extension → Language server: connects to server