rgen-tool 0.1.0

rgen is a deterministic, language-agnostic code generation framework that treats software artifacts as projections of knowledge graphs.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

# Example: CLI subcommand

## Using Marketplace Rpack (Recommended)

### 1. Search and Install

```bash
# Search for CLI subcommand rpacks
rgen search rust cli

# Install the rpack
rgen add io.rgen.rust.cli-subcommand
```

### 2. Generate Code

```bash
# Generate using the rpack template
rgen gen io.rgen.rust.cli-subcommand:cli/subcommand/rust.tmpl name=status description="Show application status"
```

### 3. Verify Output

```bash
# Check generated file
cat src/cmds/status.rs
```

Output:

```rust
// Generated by rpack: io.rgen.rust.cli-subcommand
// Template: cli/subcommand/rust.tmpl

use clap::Parser;

#[derive(Parser)]
pub struct StatusArgs {
    /// Show application status
    #[arg(short, long)]
    pub verbose: bool,
}

pub fn status(args: StatusArgs) -> Result<(), Box<dyn std::error::Error>> {
    println!("Application status: Running");
    if args.verbose {
        println!("Detailed status information...");
    }
    Ok(())
}
```

## Using Local Template (Advanced)

Create `templates/cli/subcommand/rust.tmpl` (see quickstart for full template).

Generate:
```bash
rgen gen cli subcommand --vars cmd=status summary="Show status"
```

Outputs:

```
src/cmds/status.rs
```

## Comparison

| Approach | Setup Time | Quality | Updates | Best For |
|----------|------------|---------|---------|----------|
| **Marketplace** | Instant | Community tested | Automatic | Most users |
| **Local** | Manual | Custom | Manual | Special needs |

## Next Steps

- Try the [multi-language example](cli-subcommand-multi.md)
- Explore [marketplace rpacks](marketplace.md)
- Learn about [template development](templates.md)