template-python-uv-script

Opinionated Python + uv template for new scripts.

Getting Started

1. Go to or create the project folder.
2. Get the template files:

npx giget github:joaopalmeiro/template-python-uv-script . --force

3. Search for template-python-uv-script and replace it with the project name. Ignore the template repository URL in the NOTES.md file.
4. Search for Opinionated [Python](https://www.python.org/) + [uv](https://github.com/astral-sh/uv) template for new scripts. and replace it with the (short) project description.
5. Search for João Palmeiro and replace it with the author's name.
6. Open the requirements.txt file and add the project-specific dependencies.
7. Delete the deprecated/ folder.
8. Delete the TEMPLATE.md file.
9. Delete the Getting Started section.

Development

Install uv (if necessary).

uv python install

uv venv .venv --verbose

cat .venv/pyvenv.cfg

source .venv/bin/activate

which python && python --version

uv pip install -r requirements.txt --strict

uv pip list --strict

uv pip check --verbose

uv pip tree --show-version-specifiers --strict

ruff check

mypy

ruff check --fix

ruff format

python 01.py

deactivate