Skip to content

Commit 2a39a55

Browse files
noahgiftclaude
andcommitted
docs: Update README with comprehensive single-shot compile status matrix
Update compatibility table to reflect latest depyler testing results: **Single-Shot Compile Matrix (11 examples)**: - Transpilation: 11/11 (100%) ✅ - All examples generate Rust code - Dependency Generation: 11/11 (100%) ✅ - Automatic Cargo.toml - Single-Shot Compile: 2/11 (18.2%) - example_simple, example_flags **New Table Columns**: - Transpile: AST → Rust code generation status - Build: Cargo build success/failure - Run: Binary execution status - Blocker: Primary issue preventing build - Details: Specific error counts and categories **Updated Project Structure**: - Now lists all 11 examples (was 6) - Added: config, subprocess, environment, io_streams, regex **Recent Achievements Highlighted**: - DEPYLER-0381: sys.stdin/stdout/stderr - DEPYLER-0383: Walrus operator, hashlib, pathlib - DEPYLER-0384: Automatic Cargo.toml with 20+ crates Links to GitHub Issue #3 for detailed tracking and reproducibility. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
1 parent d2cd3dd commit 2a39a55

File tree

1 file changed

+41
-22
lines changed

1 file changed

+41
-22
lines changed

README.md

Lines changed: 41 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -71,13 +71,18 @@ cat profile.txt | flamegraph.pl > flamegraph.svg
7171

7272
```
7373
reprorusted-python-cli/
74-
├── examples/ # 6 argparse CLI examples (simple → complex)
75-
│ ├── example_simple/ # Trivial CLI with basic argparse
76-
│ ├── example_flags/ # Boolean flags and combinations
77-
│ ├── example_positional/ # Positional arguments
74+
├── examples/ # 11 argparse CLI examples (simple → complex)
75+
│ ├── example_simple/ # Trivial CLI with basic argparse
76+
│ ├── example_flags/ # Boolean flags and combinations
77+
│ ├── example_positional/ # Positional arguments (nargs)
7878
│ ├── example_subcommands/ # Git-like subcommand pattern
79-
│ ├── example_complex/ # Advanced argparse features
80-
│ └── example_stdlib/ # Integration with stdlib modules
79+
│ ├── example_complex/ # Advanced argparse features (validators, types)
80+
│ ├── example_config/ # Configuration files and defaults
81+
│ ├── example_subprocess/ # subprocess.run() integration
82+
│ ├── example_environment/ # os.environ, os.path, sys.platform
83+
│ ├── example_io_streams/ # File I/O, stdin/stdout, tempfile
84+
│ ├── example_regex/ # re module pattern matching
85+
│ └── example_stdlib/ # hashlib, json, pathlib integration
8186
├── benchmarks/ # Scientific performance benchmarking
8287
│ ├── micro/ # Microbenchmarks (argparse overhead, startup, etc.)
8388
│ └── macro/ # Real-world CLI scenarios
@@ -88,22 +93,36 @@ reprorusted-python-cli/
8893

8994
## Examples
9095

91-
### Depyler Compatibility Status
92-
93-
As of depyler v3.20.2 (latest - commit 2e5d63a), the `depyler compile` command works for most argparse patterns:
94-
95-
| Example | `depyler compile` | Manual Rust | Test Count | Status |
96-
|---------|-------------------|-------------|------------|--------|
97-
| **example_simple** | ✅ Works | ✅ Available | 23 tests | Full support |
98-
| **example_flags** | ✅ Works | ✅ Available | 33 tests | Full support |
99-
| **example_positional** | ✅ Works | ✅ Available | 27 tests | Full support |
100-
| **example_subcommands** |**Works** | ✅ Available | 37 tests | **Full support (FIXED!)** |
101-
| **example_complex** | ❌ Build fails | ✅ Available | 43 tests | Option type issues |
102-
| **example_stdlib** | ❌ Transpile fails | ✅ Available | 29 tests | Expression type not supported |
103-
104-
**Progress:** 4/6 examples compile successfully with `depyler compile` (66.7%) 🎉
105-
106-
**Recent Fix (DEPYLER-0396):** Subcommands example now fully working - all borrow checker issues resolved!
96+
### Depyler Single-Shot Compile Status
97+
98+
**Latest Testing**: depyler v3.20.0+47 (with DEPYLER-0381, 0383, 0384 integration)
99+
100+
**Single-Shot Compile**: Python → Rust binary in one command (`depyler compile example.py -o binary`)
101+
102+
| Example | Transpile | Build | Run | Blocker | Details |
103+
|---------|-----------|-------|-----|---------|---------|
104+
| **example_simple** |||| None | **Full single-shot support** |
105+
| **example_flags** |||| None | **Full single-shot support** |
106+
| **example_positional** |||| Vec Display | 1 error: `Vec<String>` lacks Display trait |
107+
| **example_subcommands** |||| Field access | 7 errors: struct field access issues |
108+
| **example_complex** |||| Exception handling | 28 errors: Exception type not found |
109+
| **example_config** |||| Not tested | Global constants, Path conversions |
110+
| **example_subprocess** |||| Not tested | subprocess.run() transpilation |
111+
| **example_environment** |||| Missing imports | 27 errors: serde_json not imported |
112+
| **example_io_streams** |||| Missing imports | 47 errors: serde_json not imported |
113+
| **example_regex** |||| Type inference | 50 errors: regex type mismatches |
114+
| **example_stdlib** |||| Type system | 41 errors: function pointer issues |
115+
116+
**Progress:**
117+
- **Transpilation**: 11/11 (100%) ✅ - All examples generate Rust code
118+
- **Dependency Generation**: 11/11 (100%) ✅ - Automatic Cargo.toml with crate detection
119+
- **Single-Shot Compile**: 2/11 (18.2%) 🎯 - From Python source to working binary
120+
- **Detailed Tracking**: [GitHub Issue #3](https://github.com/paiml/reprorusted-python-cli/issues/3)
121+
122+
**Recent Achievements:**
123+
-**DEPYLER-0381**: sys.stdin/stdout/stderr support
124+
-**DEPYLER-0383**: Walrus operator (PEP 572), hashlib, pathlib fixes
125+
-**DEPYLER-0384**: Automatic Cargo.toml generation with 20+ crate detection
107126

108127
All examples include working Rust binaries (manual implementations) with 100% I/O equivalence validation.
109128

0 commit comments

Comments
 (0)