use uv

Author: branchv

.github/workflows/ci.yaml

@@ -12,13 +12,13 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
       - name: Install dependencies
-        run: pipx install copier poetry
+        run: pipx install copier uv
       - name: Run test
         run: |
           git config --global user.name "GitHub Action"
           git config --global user.email "[email protected]"
           copier copy --trust -f -d docker=True -d docs=True . build/ && cd build/
-          poetry run task lint
+          uv run task lint
       - name: Push rendered project
         if: github.ref == 'refs/heads/main' && github.event_name == 'push'
         run: |

Makefile

@@ -9,8 +9,8 @@ build:
 
 .PHONY: test
 test:
-	@poetry -C build run task lint
-	@poetry -C build run task test -q
+	@uv --directory=build run task lint
+	@uv --directory=build run task test -q
 
 .PHONY: release
 release:

README.md

@@ -12,7 +12,7 @@ uvx copier copy --trust gh:branchvincent/python-template .
 
 ## Features
 
-- Package manager: [Poetry](https://python-poetry.org/)
+- Package manager: [uv](https://docs.astral.sh/uv/)
 - Formatting: [Ruff](https://docs.astral.sh/ruff/formatter/)
 - Testing: [pytest](https://docs.pytest.org/en/latest/)
 - Linting: [Ruff](https://docs.astral.sh/ruff/linter/) and [pre-commit](https://pre-commit.com/)

copier.yaml

@@ -39,7 +39,7 @@ _exclude:
 _skip_if_exists:
   - pyproject.toml
 _tasks:
-  - "[ -d .git ] || poetry install -q"
+  - "[ -d .git ] || uv sync -q"
   - "[ -d .git ] || git init -q && git add --all && git commit -qm 'initial commit'"
   - "[ -d .git ] || touch .envrc"
   - printf "To create your repo:\n  gh repo create -y {{repo_username}}/{{repo_name}} {% if private %}--private{% else %}--public{% endif %}\n"

src/.github/workflows/ci.yaml.jinja

@@ -11,18 +11,17 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - name: Set up Poetry
-        run: pipx install poetry
+      - name: Set up uv
+        run: pipx install uv
       - uses: actions/setup-python@v5
         with:
           python-version: 3.13
-          cache: poetry
       - name: Install package
-        run: poetry install
+        run: uv sync --frozen
       - name: Run linters
-        run: poetry run task lint
+        run: uv run task lint
       - name: Run tests
-        run: poetry run task test
+        run: uv run task test
 
   release:
     needs: build
@@ -51,9 +50,9 @@ jobs:
       {% if not private -%}
       - name: Publish to PyPI
         if: steps.version.outputs.skipped == 'false'
-        run: pipx run poetry publish --build
+        run: uv build && uv publish
         env:
-          POETRY_PYPI_TOKEN_PYPI: {% raw %}${{ secrets.PYPI_TOKEN }}{% endraw %}
+          UV_PUBLISH_TOKEN: {% raw %}${{ secrets.PYPI_TOKEN }}{% endraw %}
       {% endif -%}
       {% if docker -%}
       - uses: satackey/[email protected]

src/.github/workflows/{% if docs %}docs.yaml{% endif %}

@@ -12,13 +12,12 @@ jobs:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
-      - name: Set up Poetry
-        run: pipx install poetry
+      - name: Set up uv
+        run: pipx install uv
       - uses: actions/setup-python@v5
         with:
           python-version: 3.13
-          cache: poetry
       - name: Install package
-        run: poetry install
+        run: uv sync --frozen --all-extras
       - name: Publish docs
-        run: poetry run mkdocs gh-deploy
+        run: uv run mkdocs gh-deploy

src/.pre-commit-config.yaml

@@ -3,19 +3,19 @@ repos:
     hooks:
       - id: ruff-format
         name: ruff-format
-        entry: poetry run ruff format
+        entry: uv run ruff format
         require_serial: true
         language: system
         types: [python]
       - id: ruff-check
         name: ruff-check
-        entry: poetry run ruff check
+        entry: uv run ruff check
         require_serial: true
         language: system
         types: [python]
       - id: mypy
         name: mypy
-        entry: poetry run mypy
+        entry: uv run mypy
         require_serial: true
         language: system
         types: [python]

src/CONTRIBUTING.md

@@ -1,25 +1,25 @@
 # Contributing
 
-Before getting started, install [Poetry](https://python-poetry.org/docs/#installation).
+Before getting started, install [uv](https://docs.astral.sh/uv/getting-started/installation).
 
 ## Getting Started
 
 To install the project:
 
 ```sh
-poetry install
+uv sync
 ```
 
 Optionally, you can also install [pre-commit](https://pre-commit.com/) hooks:
 
 ```sh
-poetry run pre-commit install
+uv run pre-commit install
 ```
 
 Lastly, to see common tasks with [taskipy](https://github.com/illBeRoy/taskipy):
 
 ```sh
-poetry run task --list
+uv run task --list
 ```
 
 ## Linting
@@ -32,15 +32,15 @@ To ensure code quality, we use the following tools:
 To run these:
 
 ```sh
-poetry run task lint
+uv run task lint
 ```
 
 ## Testing
 
 To run tests via [pytest](https://docs.pytest.org/en/latest/):
 
 ```sh
-poetry run task test
+uv run task test
 ```
 
 ## Releasing

src/pyproject.toml.jinja

@@ -4,23 +4,18 @@ version = "0.1.0"
 description = "{{project_description}}"
 readme = "README.md"
 authors = [{ name = "{{author_name}}", email = "{{author_email}}" }]
-requires-python = ">=3.10,<4.0"
+requires-python = ">=3.10"
 dependencies = []
 urls.repository = "https://github.com/{{repo_username}}/{{repo_name}}"
 {%- if private %}
 classifiers = ["Private :: Do Not Upload"]
 {%- endif %}
 
-[tool.poetry.group.dev.dependencies]
-{% if docs -%}
-mkdocs = ">=1"
-mkdocs-material = ">=9"
-{% endif -%}
-mypy = ">=1"
-pre-commit = ">=4"
-pytest = ">=8"
-ruff = ">=0.11"
-taskipy = ">=1"
+[dependency-groups]
+{%- if docs %}
+docs = ["mkdocs", "mkdocs-material"]
+{%- endif %}
+dev = ["mypy", "pre-commit", "pytest", "ruff", "taskipy"]
 
 [tool.taskipy.tasks]
 clean = { cmd = "rm -rf .*_cache/ dist/", help = "Remove build artifacts" }
@@ -30,17 +25,17 @@ docs = { cmd = "mkdocs serve -f docs/mkdocs.yaml", help = "Serve documentation"}
 lint = { cmd = "pre-commit run --all-files", help = "Run linters and formatters" }
 test = { cmd = "pytest", help = "Run tests" }
 
-[tool.ruff]
-fix = true
-lint = { select = ["B", "E", "F", "I", "SIM", "UP"] }
-
 [tool.mypy]
 strict = true
 ignore_missing_imports = true
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 
+[tool.ruff]
+fix = true
+lint = { select = ["B", "E", "F", "I", "SIM", "UP"] }
+
 [build-system]
-requires = ["poetry-core>=2.0"]
-build-backend = "poetry.core.masonry.api"
+requires = ["flit_core >=3.2,<4"]
+build-backend = "flit_core.buildapi"

src/{% if docker %}.dockerignore{% endif %}

@@ -1,4 +1,5 @@
 *
 !src/*
+!README.md
 !pyproject.toml
-!poetry.lock
+!uv.lock