Oak Python Parser
High-performance incremental Python parser for the oak ecosystem with flexible configuration, optimized for static analysis and code generation.
🎯 Overview
Oak Python is a robust parser for Python, designed to handle complete Python syntax including modern features. Built on the solid foundation of oak-core, it provides both high-level convenience and detailed AST generation for static analysis and code generation.
✨ Features
- Complete Python Syntax: Supports all Python features including modern specifications
- Full AST Generation: Generates comprehensive Abstract Syntax Trees
- Lexer Support: Built-in tokenization with proper span information
- Error Recovery: Graceful handling of syntax errors with detailed diagnostics
🚀 Quick Start
Basic example:
use ;
📋 Parsing Examples
Function Parsing
use ;
let parser = new;
let source = new;
let result = parser.parse;
println!;
Class Parsing
use ;
let parser = new;
let source = new;
let result = parser.parse;
println!;
🔧 Advanced Features
Token-Level Parsing
use ;
let parser = new;
let source = new;
let result = parser.parse;
println!;
Error Handling
use ;
let parser = new;
let source = new;
let result = parser.parse;
if let Some = result.result.err else
🏗️ AST Structure
The parser generates a comprehensive AST with the following main structures:
- Module: Root container for Python programs
- Function: Python functions and methods
- Class: Python class definitions
- Statement: Various statement types (assignment, if, loop, etc.)
- Expression: Various expression types (binary, unary, call, etc.)
📊 Performance
- Streaming: Parse large Python files without loading entirely into memory
- Incremental: Re-parse only changed sections
- Memory Efficient: Smart AST node allocation
- Fast Recovery: Quick error recovery for better IDE integration
🔗 Integration
Oak Python integrates seamlessly with:
- Static Analysis: Code quality and security analysis
- Code Generation: Generating code from Python AST
- IDE Support: Language server protocol compatibility
- Refactoring: Automated code refactoring
- Documentation: Generating documentation from Python code
📚 Examples
Check out the examples directory for comprehensive examples:
- Complete Python program parsing
- Function and class analysis
- Code transformation
- Integration with development workflows
🤝 Contributing
Contributions are welcome!
Please feel free to submit pull requests at the project repository or open issues.