Switch poetry to uv

Author: Piotr Rarus

.flake8

@@ -11,17 +11,21 @@ jobs:
     - name: Checkout repository
       uses: actions/checkout@v4
 
+    - name: Install UV
+      uses: astral-sh/setup-uv@v5
+      with:
+        version: "0.6.5"
+        enable-cache: true
+        cache-dependency-glob: "uv.lock"
+
     - name: Install Poetry
       uses: snok/install-poetry@v1
       with:
         virtualenvs-in-project: true
         virtualenvs-path: .venv
 
-    - name: Set up Python 3.11
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.11'
-        cache: 'poetry'
+    - name: Set up Python 3.12
+      run: uv python install
 
     - name: Cache pre-commit
       uses: actions/cache@v4
@@ -36,26 +40,25 @@ jobs:
         key: mypy_cache-${{ runner.os }}-${{ steps.setup-python.outputs.python-version }}-${{ hashFiles('poetry.lock') }}
 
     - name: Install dependencies
-      if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
-      run: poetry install --no-interaction --no-root --with dev
+      run: uv sync --all-extras --test
 
     - name: pre-commit
       run: |
-        poetry run pre-commit run -a
+        uv run pre-commit run -a
 
     - name: Mypy
       run: |
-        poetry run mypy --incremental --no-install-types --show-error-codes --pretty src tests
+        uv run mypy --incremental --no-install-types --show-error-codes --pretty src tests
 
     - name: Tests
       run: |
-        poetry run coverage run -m pytest --cov-config=.coveragerc
+        uv run coverage run -m pytest --cov-config=.coveragerc
 
     - name: Tests coverage
       run: |
-        poetry run coverage html
-        poetry run coverage xml
-        poetry run coverage report --show-missing
+        uv run coverage html
+        uv run coverage xml
+        uv run coverage report --show-missing
 
     # Requires CODECOV_TOKEN in repository secrets
     - name: Upload codecov

.github/workflows/build.yml

@@ -94,13 +94,6 @@ ipython_config.py
 #   install all needed dependencies.
 #Pipfile.lock
 
-# poetry
-#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
-#   This is especially recommended for binary packages to ensure reproducibility, and is more
-#   commonly ignored for libraries.
-#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
-#poetry.lock
-
 # pdm
 #   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
 #pdm.lock

.gitignore

@@ -1,5 +1,5 @@
 exclude: '.git|.tox'
-default_stages: [commit]
+default_stages: [pre-commit]
 fail_fast: true
 
 repos:
@@ -24,44 +24,32 @@ repos:
     hooks:
       - id: codespell
         name: codespell
-        entry: poetry run codespell
+        entry: uv run codespell
         language: system
         types_or: [python, rst, markdown]
         files: ^src/
 
       - id: isort
         name: isort
-        entry: poetry run isort
+        entry: uv run isort
         language: system
         files: ^src/
 
       - id: pyupgrade
         name: pyupgrade
-        entry: poetry run pyupgrade
+        entry: uv run pyupgrade
         language: system
         args: [--py311-plus]
         files: ^src/
 
-      - id: yesqa
-        name: yesqa
-        entry: poetry run yesqa
-        language: system
-        files: ^src/
-
       - id: black
         name: black
-        entry: poetry run black
+        entry: uv run black
         language: system
         files: ^src/
 
       - id: ruff
         name: ruff
-        entry: poetry run ruff
-        language: system
-        files: ^src/
-
-      - id: flake8
-        name: flake8
-        entry: poetry run flake8
+        entry: uv run ruff check
         language: system
         files: ^src/

.pre-commit-config.yaml

@@ -1,34 +1,41 @@
+.PHONY: venv sync update lock format lint test test_cov build
+
 # Creates a virtual environment and installs dependencies for local development.
 venv:
-	poetry install --no-root
-	poetry run pre-commit install
+	uv sync --all-groups --all-extras --frozen --reinstall
+
+# Syncs the dependencies for local development.
+sync:
+	uv sync --all-groups --all-extras
+
+# Updates the dependencies to the latest versions.
+update:
+	uv sync --all-groups --all-extras --upgrade
 
 # Locks the versions of project dependencies for consistency.
 lock:
-	poetry lock --no-update
+	uv lock
 
 # Formats code using isort and black for consistent style.
 format:
-	poetry run isort src
-	poetry run black --config pyproject.toml src
+	uv run isort src
+	uv run black --config pyproject.toml src
 
 # Runs all linters to catch potential issues and enforce style.
 lint:
-	poetry run pre-commit run -a
-	poetry run ruff check src
-	poetry run flake8 src
-	poetry run mypy --incremental --no-install-types --show-error-codes --pretty src
+	uv run pre-commit run -a
+	uv run mypy --incremental --no-install-types --show-error-codes --pretty src
 
 # Runs pytest tests to ensure code correctness.
 test:
-	poetry run pytest
+	uv run pytest
 
 # Runs tests with coverage and generates a report.
 test_cov:
-	poetry run coverage run -m pytest src --cov-config=.coveragerc
-	poetry run coverage html
-	poetry run coverage xml
-	poetry run coverage report --show-missing
+	uv run coverage run -m pytest src --cov-config=.coveragerc
+	uv run coverage html
+	uv run coverage xml
+	uv run coverage report --show-missing
 
 # Runs pre-commit hooks, mypy checks, and tests. Quite useful before pushing changes.
 build: format lint test

Makefile

@@ -15,14 +15,14 @@ This is a template repository dedicated to `Python` projects. It provides some b
 
 ## Prerequisites
 
-In order to use this template, you need to have both `poetry` and `make` installed.
+In order to use this template, you need to have both `uv` and `make` installed.
 
-### Poetry
+### uv
 
-`poetry` is a package manager we're using. You can check the installation instructions [here](https://python-poetry.org/docs/#installing-with-the-official-installer). You should avoid installing `poetry` through `pip` as it is a system-level tool, separated from the `Python` runtime you're currently using. It enables us to treat `Python` as any other dependency and pin its version in `pyproject.toml`.
+`uv` is a package manager we're using. You can check the installation instructions [here](https://docs.astral.sh/uv/getting-started/installation/). You should avoid installing `poetry` through `pip` as it is a system-level tool, separated from the `Python` runtime you're currently using. It enables us to treat `Python` as any other dependency and pin its version in `pyproject.toml`.
 
 ```sh
-curl -sSL https://install.python-poetry.org | python3 -
+curl -LsSf https://astral.sh/uv/install.sh | sh
 ```
 
 ### make
@@ -82,16 +82,14 @@ make build  # format lint test
 - `.pre-commit-config.yaml` - pre-commit pipeline configuration
 - `Makefile` - tasks definitions, much simpler to call `make` than writing whole commands in the terminal; it's also easy to check what project-specific functionalities you're exposing
 - `mypy.ini` - `mypy` config, usually some of your dependencies won't be hinted so you're gonna ignore them here
-- `poetry.lock` - compiled dependencies
-- `poetry.toml` - `poetry` config, as you shouldn't enforce other devs where to put their virtual environment this must be a separate config file
+- `uv.lock` - compiled dependencies
 - `pyproject.toml` - repo config
 
 ## Tools
 
 When developing a project there's a need to automate some tedious stuff that helps you keep the repo clean and check it against common standards. These include managing the environment, dependencies, syntax, etc.
 
-- [poetry](https://github.com/python-poetry/poetry)
-- [flake8](https://github.com/PyCQA/flake8)
+- [uv](https://github.com/astral-sh/uv)
 - [isort](https://github.com/PyCQA/isort)
 - [ruff](https://github.com/charliermarsh/ruff)
 - [black](https://github.com/psf/black)