Skip to content

Commit 61d27c4

Browse files
committed
📝 cruft
1 parent 20677a9 commit 61d27c4

File tree

2 files changed

+48
-2
lines changed

2 files changed

+48
-2
lines changed

README.md

Lines changed: 25 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22
<h1 style="font-size: 36px; margin-top: 0;" align="center">
33
cookiecutter-python
44
</h1>
5-
<p style="margin-bottom: 0;" align="center">
5+
<a href="https://github.com/juftin/cookiecutter-python">
66
<img src="https://i.imgur.com/g8yxsTP.png" width="400">
7-
</p>
7+
</a>
88
</div>
99

1010
[juftin]'s personal [cookiecutter] template for Python projects.
@@ -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

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)