@@ -14,27 +14,23 @@ This is not the one-shot solution to project structure or packaging. This is
14
14
just what works well for one egg on the Internet. Feel free to use it as you see
15
15
fit.
16
16
17
+ ## Prerequisites
18
+
19
+ - [ ** uv** ] ( https://docs.astral.sh/uv ) >= 0.6.3
20
+
17
21
## FAQ
18
22
23
+ - ** Q:** Why uv over venv and setup-tools?
24
+ - ** A:** Primarily because of the lower barrier of entry that the uv workflow
25
+ offers to the next-dev and the non-dev. Speed is nice, but where Astral has
26
+ really pushed value with uv is in the simplicity.
27
+
19
28
- ** Q:** Should I follow everything to the absolute letter in this template?
20
29
- ** A:** Heck no, I don't even do that! This is just the closest
21
30
one-size-fits-most template I've put together. Use what you want how you
22
31
want.
23
32
24
- - ** Q:** Why not put the requirements into the ` pyproject.toml ` ?
25
- - ** A:** Mostly because ` pip-compile ` does all the work for me and doesn't
26
- target the ` pyproject.toml ` . Partly because many of my projects need to be
27
- scanned by utilities that still think ` requirements.txt ` is the only pattern
28
- to use.
29
-
30
33
- ** Q:** Why does this template change so often?
31
34
- ** A:** I'm constantly finding new tweaks that make the template fit just a
32
35
little better. I'm also open to ideas and suggestions so please drop an
33
36
issue if you have one.
34
-
35
- - ** Q:** Have I heard of uv?
36
- - ** A:** Yes. I'm already exploring a uv driven workflow for this template.
37
- You can see it on the ` uv-workflow ` branch. I will be waiting until the
38
- April 2025 release of pip for support of
39
- [ dependency-groups] ( https://packaging.python.org/en/latest/specifications/dependency-groups/ )
40
- before committing to any changes.
0 commit comments