@@ -14,27 +14,23 @@ This is not the one-shot solution to project structure or packaging. This is
1414just what works well for one egg on the Internet. Feel free to use it as you see
1515fit.
1616
17+ ## Prerequisites
18+
19+ - [ ** uv** ] ( https://docs.astral.sh/uv ) >= 0.6.3
20+
1721## FAQ
1822
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+
1928- ** Q:** Should I follow everything to the absolute letter in this template?
2029 - ** A:** Heck no, I don't even do that! This is just the closest
2130 one-size-fits-most template I've put together. Use what you want how you
2231 want.
2332
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-
3033- ** Q:** Why does this template change so often?
3134 - ** A:** I'm constantly finding new tweaks that make the template fit just a
3235 little better. I'm also open to ideas and suggestions so please drop an
3336 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