Skip to content

Commit 8192d3c

Browse files
committed
📝 cruft
1 parent 20677a9 commit 8192d3c

File tree

2 files changed

+49
-1
lines changed

2 files changed

+49
-1
lines changed

README.md

Lines changed: 26 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,9 @@
33
cookiecutter-python
44
</h1>
55
<p style="margin-bottom: 0;" align="center">
6-
<img src="https://i.imgur.com/g8yxsTP.png" width="400">
6+
<a href="https://github.com/juftin/cookiecutter-python">
7+
<img src="https://i.imgur.com/g8yxsTP.png" width="400">
8+
</a>
79
</p>
810
</div>
911

@@ -92,6 +94,28 @@ sync your secrets to GitHub, run the following command with the [GitHub CLI]:
9294
gh secret set --env-file .env
9395
```
9496

97+
#### cruft
98+
99+
[cruft] is a tool for updating cookiecutter templates after they've been
100+
generated. To use cruft, install it with `pipx`:
101+
102+
```shell
103+
pipx install cruft
104+
```
105+
106+
Then, use `cruft` instead of `cookiecutter` to generate your project:
107+
108+
```shell
109+
cruft create https://github.com/juftin/cookiecutter-python
110+
```
111+
112+
Later, if you want to update your project with the latest changes from
113+
the template:
114+
115+
```shell
116+
cruft update
117+
```
118+
95119
#### Developing
96120

97121
This project generates its own documentation for how to use the
@@ -123,3 +147,4 @@ Once the server is running, you can view the documentation at
123147
[ruff]: https://github.com/astral/ruff/
124148
[mypy]: https://github.com/python/mypy
125149
[juftin.com/cookiecutter-python/contributing]: https://juftin.com/cookiecutter-python/contributing/
150+
[cruft]: https://github.com/cruft/cruft

docs/index.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -92,6 +92,28 @@ sync your secrets to GitHub, run the following command with the [GitHub CLI]:
9292
gh secret set --env-file .env
9393
```
9494

95+
#### cruft
96+
97+
[cruft] is a tool for updating cookiecutter templates after they've been
98+
generated. To use cruft, install it with `pipx`:
99+
100+
```shell
101+
pipx install cruft
102+
```
103+
104+
Then, use `cruft` instead of `cookiecutter` to generate your project:
105+
106+
```shell
107+
cruft create https://github.com/juftin/cookiecutter-python
108+
```
109+
110+
Later, if you want to update your project with the latest changes from
111+
the template:
112+
113+
```shell
114+
cruft update
115+
```
116+
95117
#### Developing
96118

97119
This project generates its own documentation for how to use the
@@ -123,3 +145,4 @@ Once the server is running, you can view the documentation at
123145
[ruff]: https://github.com/astral/ruff/
124146
[mypy]: https://github.com/python/mypy
125147
[juftin.com/cookiecutter-python/contributing]: https://juftin.com/cookiecutter-python/contributing/
148+
[cruft]: https://github.com/cruft/cruft

0 commit comments

Comments
 (0)