migrating from poetry to uv

Author: andredias

Makefile

@@ -19,7 +19,7 @@ test:
 	--keep-project-on-failure -o /tmp .
 
 	cd /tmp/$(TARGET_NAME); \
-	poetry run make lint && \
-	poetry run make test && \
-	poetry run make audit && \
+	uv run make lint && \
+	uv run make test && \
+	uv run make audit && \
 	echo '\nSuccess!'

README.rst

@@ -8,8 +8,8 @@ The article `How to Set up a Perfect Python Project <https://blog.pronus.xyz/en/
 Features
 --------
 
-* Python 3.10+ (configurable)
-* Poetry_ based dependency management
+* Python 3.14+ (configurable)
+* uv_ based dependency management
 * Development tasks registered in a ``Makefile`` for easy access and management
 * Custom Mercurial/Git hooks for ``pre-commit`` and ``pre-push`` events
 * Linting based on ruff_, mypy_ and others
@@ -20,17 +20,17 @@ Instructions
 ============
 
 To instantiate the template into a new project, you'll need cookiecutter_ (>=2.4.0).
-The best way to use it just once is through pipx_:
+The best way to use it just once is through uvx_:
 
 .. code:: console
 
-    $ pipx run cookiecutter gh:andredias/perfect_python_project
+    $ uvx run cookiecutter gh:andredias/perfect_python_project
 
-If you prefer, use can install it throught `pip` instead:
+If you prefer, use can install it throught ``uv tool`` instead:
 
 .. code:: console
 
-    $ pip install --user cookiecutter
+    $ uv tool install cookiecutter
 
 Next, run the following command:
 
@@ -58,7 +58,7 @@ That's it!
 
 .. _cookiecutter: https://github.com/cookiecutter/cookiecutter
 .. _mypy: http://mypy-lang.org/
-.. _pipx: https://pypa.github.io/pipx/
-.. _Poetry: https://python-poetry.org/
 .. _pytest: https://pytest.org
 .. _ruff: https://pypi.org/project/ruff/
+.. _uv: https://docs.astral.sh/uv/
+.. _uvx: https://docs.astral.sh/uv/guides/tools/

cookiecutter.json

@@ -1,7 +1,7 @@
 {
   "author": "",
   "email": "",
-  "project_name": "Perfect Python Project",
+  "project_name": "Perfect_Python_Project",
   "project_slug": "{{ cookiecutter.project_name.lower().replace(' ', '_').replace('-', '_') }}",
   "python_version": "3.12",
   "line_length": 100,

hooks/post_gen_project.sh

@@ -2,10 +2,8 @@
 
 set -xuo pipefail
 
-poetry env use {{cookiecutter.python_version}}
-poetry lock --no-update
-poetry install
-poetry run make format
+uv sync --no-install-project
+uv run make format
 
 commit_message="Initial project structure based on https://github.com/andredias/perfect_python_project/tree/master"
 

{{cookiecutter.project_slug}}/.github/workflows/continuous_integration.yml

@@ -9,34 +9,30 @@ jobs:
     steps:
 
         - name: Set up python
-          uses: actions/setup-python@v4
+          uses: actions/setup-python@v6
           with:
-              python-version: '{{cookiecutter.python_version}}'
+              python-version-file: "pyproject.toml"
 
         - name: Check out repository
-          uses: actions/checkout@v3
+          uses: actions/checkout@v5
 
-        - name: Install Poetry
-          uses: snok/install-poetry@v1
+        - name: Install uv
+          uses: astral-sh/setup-uv@v6
           with:
-              virtualenvs-in-project: true
-
-        - name: Load cached venv
-          id: cached-poetry-dependencies
-          uses: actions/cache@v3
-          with:
-              path: .venv
-              key: venv-{{ "${{ hashFiles('**/poetry.lock') }}" }}
+              version: "0.9.8"
+              enable-cache: true
 
         - name: Install dependencies
-          if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
-          run: poetry install --no-interaction
+          run: uv sync --locked --no-install-project
+
+        - name: Testing
+          run: uv run --locked make test
 
         - name: Linting
-          run: poetry run make lint
+          run: uv run --locked make lint
 
         - name: Auditing
-          run: poetry run make audit
+          run: uv run make audit
 
-        - name: Test
-          run: poetry run make test
+        - name: Minimize uv cache
+          run: uv cache prune --ci

{{cookiecutter.project_slug}}/poetry.lock

@@ -1,23 +1,21 @@
-[tool.poetry]
-name = "{{cookiecutter.project_name}}"
-version = "0.1.0"
+[project]
+name = "{{cookiecutter.project_slug}}"
 description = ""
-authors = ["{{cookiecutter.author}} <{{cookiecutter.email}}>"]
-package-mode = false
-
-[build-system]
-requires = ["poetry-core>=1.0.0"]
-build-backend = "poetry.core.masonry.api"
-
-[tool.poetry.dependencies]
-python = "^{{cookiecutter.python_version}}"
-
-[tool.poetry.group.dev.dependencies]
-mypy = "*"
-pip-audit = "*"
-pytest = "*"
-pytest-cov = "*"
-ruff = "*"
+authors = [
+    {name="{{cookiecutter.author}}", email="{{cookiecutter.email}}"},
+]
+dynamic = ["version"]
+requires-python = "~={{cookiecutter.python_version}}.0"
+readme = "README.rst"
+
+[dependency-groups]
+dev = [
+    "mypy",
+    "pip-audit",
+    "pytest",
+    "pytest-cov",
+    "ruff",
+]
 
 [tool.pytest.ini_options]
 filterwarnings = ["ignore::DeprecationWarning"]

{{cookiecutter.project_slug}}/pyproject.toml

@@ -2,11 +2,11 @@
 
 GIT_PRE_PUSH='#!/usr/bin/env bash
 cd $(git rev-parse --show-toplevel)
-poetry run make lint && poetry run make test && poetry run make audit
+uv run --locked make lint && uv run --locked make test && uv run make audit
 '
 
 HG_HOOKS='[hooks]
-pre-push.lint_test = (cd `hg root`; poetry run make lint && poetry run make test && poetry run make audit)
+pre-push.lint_test = (cd `hg root`; uv run --locked make lint && uv run --locked make test && uv run make audit)
 '
 
 if [ -d '.git' ]; then