duck-template 0.1.9

A cli tool for generating files from a template just with a json file
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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

<p align="center">
  <img src="./public/logo-dark.svg" alt="duck-template" width="120"/>
</p>

<h1 align="center">duck-template</h1>

<p align="center">
  Fast, JSON-driven Rust scaffolder for projects, files, and variants.
</p>

<p align="center">
  <a href="./LICENSE">MIT</a> -
  <a href="https://crates.io/crates/duck-template">crates.io</a> -
  <a href="https://docs.rs/duck-template">docs.rs</a> -
  <a href="https://github.com/gentleeduck/duck-template/issues">issues</a>
</p>

<p align="center">
  <a href="https://crates.io/crates/duck-template"><img src="https://img.shields.io/crates/v/duck-template.svg" alt="crates.io"/></a>
  <a href="https://docs.rs/duck-template"><img src="https://docs.rs/duck-template/badge.svg" alt="docs.rs"/></a>
  <a href="./LICENSE"><img src="https://img.shields.io/crates/l/duck-template.svg" alt="MIT"/></a>
</p>

---

## Install

```sh
cargo install duck-template
```

## Quick start

```sh
duck-template init
duck-template create my-app --variant cli
duck-template create-variant web
```

The generator reads a template descriptor (local file or remote URL)
and emits the project tree from JSON. Flags are injected dynamically
into template placeholders.

## Features

| feature | what |
| --- | --- |
| JSON templates | declarative project + file scaffold |
| Variants | per-template layouts (`cli`, `api`, `web`, ...) |
| Local or remote configs | path or URL |
| Dynamic flag injection | flags become template vars |
| Modular commands | `init`, `create`, `create-variant` |

## Commands

```sh
duck-template init                      # interactive setup
duck-template create <name> [--variant] # generate from current template
duck-template create-variant <name>     # add a variant under the template
```

## Schema

A template is a JSON file with this shape:

```json
{
  "name": "my-template",
  "variants": {
    "cli":  { "files": [ ... ] },
    "web":  { "files": [ ... ] }
  },
  "flags": { "name": "string", "rust_version": "string" }
}
```

See [`public/schema.json`](public/schema.json) for the full schema.

## Build from source

```sh
git clone https://github.com/gentleeduck/duck-template
cd duck-template
cargo build --release
./target/release/duck-template --help
```

## Contributing

PR checklist + style notes in [`CONTRIBUTING.md`](CONTRIBUTING.md).
Security issues: [`SECURITY.md`](SECURITY.md).
Behaviour: [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md).

## License

MIT. See [`LICENSE`](LICENSE).