chore(main): Migrate to uv (#960)

This PR removes poetry and replaces it with uv.

Also:
- remove not required pyproject.toml/requirement.txt/setup.py files ->
everything is kept in one pyproject.toml and common lock file
- remove not required Dockerfile for docs. uv run just works fine here
- keep license file in release (it is good)

closes
#957

Note: This PR is based on #920 in order to have a working CI/CD

Review notes:

- Locally build packages once in main and once in this branch.
- Compare the results.
- Test make endpoints

Author: CarliJoy

.devcontainer/Dockerfile

@@ -1,20 +1,13 @@
-FROM mcr.microsoft.com/devcontainers/python:1-3.11-bookworm
+ARG UV_VERSION=latest
 
 
-RUN \
-    apt update && apt install bash-completion -y && \
-    pip install pre-commit && \
-    curl -sSL https://install.python-poetry.org | POETRY_HOME=/home/vscode/.local python3 -
+FROM ghcr.io/astral-sh/uv:$UV_VERSION AS uv
 
 
-RUN  \
-    echo >> /home/vscode/.bashrc && \
-    # add completions to bashrc
-    # see how ubuntu does it for reference:
-    # https://git.launchpad.net/ubuntu/+source/base-files/tree/share/dot.bashrc
-    # https://stackoverflow.com/a/68566555
-    echo 'if [ -f /etc/bash_completion ] && ! shopt -oq posix; then' >> /home/vscode/.bashrc && \
-    echo '    . /etc/bash_completion' >> /home/vscode/.bashrc && \
-    echo 'fi' >> /home/vscode/.bashrc && \
-    echo >> /home/vscode/.bashrc && \
-    echo '. <(poetry completions)' >> /home/vscode/.bashrc
+FROM mcr.microsoft.com/vscode/devcontainers/base:debian
+
+ENV PYTHONDONTWRITEBYTECODE=True \
+    PYTHONUNBUFFERED=True \
+    UV_LINK_MODE=copy
+
+COPY --from=uv --chown=vscode: /uv /uvx /bin/

.devcontainer/commands/post-create-command.sh

@@ -1,4 +1,4 @@
 echo "Running post-create-command.sh"
 
 pre-commit install
-poetry install --all-extras
+uv sync --all-extras

.devcontainer/devcontainer.json

@@ -5,7 +5,7 @@
 	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
 	"build": {
 		// Path is relative to the devcontainer.json file.
-		// We prebuild the image to get poetry into the image
+		// We prebuild the image to get uv into the image
 		// This saves the user a bit of time, when re-opening containers
 		"dockerfile": "Dockerfile"
 	},

.github/CONTRIBUTING.md

@@ -23,14 +23,12 @@ We recommend following these steps:
 
 You need to have the following tools available to you:
 - `make` - You'll need a GNU Make for common developer activities
-- `poetry` - This is the primary package manager for the project
-- `pyenv` **Recommended**: For installing python versions for your system.
-  Poetry infers the current latest version from what it can find on the `PATH` so you are still fine if you don't use `pyenv`.
+- `uv` - This is the primary package manager for the project
 
 ### Build and test
 
 
-- Run `make install` to get `poetry` to install all dependencies and set up `pre-commit`
+- Run `make install` to get `uv` to install all dependencies and set up `pre-commit`
   - **Recommended**: Run `make` or `make help` to see other commands available to you.
 - After this, you should have a working virtual environment and proceed with writing code with your favourite IDE
 - **TIP**: You can run `make core/tests` or `make modules/<my-module>/tests` to run the tests specifically for that to speed up feedback cycles

.github/ISSUE_TEMPLATE/question.md

@@ -31,9 +31,9 @@ uname -a
 echo "------"
 docker info
 echo "------"
-poetry run python --version
+uv run python --version
 echo "------"
-poetry show --tree
+uv tree
 ```
 
 ```bash

.github/PULL_REQUEST_TEMPLATE/new_container.md

@@ -29,8 +29,8 @@ It helps reduce unnecessary work for you and the maintainers!
   - Your module has a `README.rst` and hooks in the `.. auto-class` and `.. title` of your container
   - Implement the new feature (typically in `__init__.py`) and corresponding tests.
 - [ ] Your module is added in `pyproject.toml`
-  - it is declared under `tool.poetry.packages` - see other community modules
-  - it is declared under `tool.poetry.extras` with the same name as your module name,
+  - it is declared under `tool.hatch.build.targets.wheel` - see other community modules
+  - it is declared under `project.optional-dependencies` with the same name as your module name,
     we still prefer adding _NO EXTRA DEPENDENCIES_, meaning `mymodule = []` is the preferred addition
     (see the notes at the bottom)
 - [ ] Your branch is up-to-date (or your branch will be rebased with `git rebase`)

.github/actions/setup-env/action.yml

@@ -10,11 +10,7 @@ inputs:
 runs:
   using: composite
   steps:
-    - name: Setup Poetry
-      run: pipx install poetry
-      shell: bash
-    - name: Setup python ${{ inputs.python-version }}
-      uses: actions/setup-python@v5
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
       with:
         python-version: ${{ inputs.python-version }}
-        cache: poetry

.github/workflows/ci-community.yml

@@ -2,6 +2,10 @@
 
 name: modules
 
+env:
+  UV_FROZEN: "1"  # use lock file as is
+  UV_NO_EDITABLE: "1"  # test the build package, not the dev installation
+
 on:
   push:
     branches: [ main ]
@@ -54,7 +58,7 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
       - name: Install Python dependencies
-        run: poetry install -E ${{ matrix.module }}
+        run: uv sync --extra ${{ matrix.module }}
       - name: Run tests
         run: make modules/${{ matrix.module }}/tests
       - name: Run doctests

.github/workflows/ci-core.yml

@@ -2,6 +2,10 @@
 
 name: core
 
+env:
+  UV_FROZEN: "1"   # use lock file as is
+  UV_NO_EDITABLE: "1"  # test the build package, not the dev installation
+
 on:
   push:
     branches: [main]
@@ -22,13 +26,11 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
       - name: Install Python dependencies
-        run: poetry install --all-extras
+        run: uv sync --all-extras
       - name: Run twine check
-        run: rm -f LICENSE.txt && poetry build && poetry run twine check dist/*.tar.gz
+        run: uv build && uv run twine check dist/*
       - name: Run tests
         run: make core/tests
-      - name: Rename coverage file
-        run: mv .coverage .coverage.${{ matrix.python-version}}
       - name: "Save coverage artifact"
         uses: actions/upload-artifact@v4
         with:
@@ -47,7 +49,7 @@ jobs:
       - name: Set up Python
         uses: ./.github/actions/setup-env
       - name: Install Python dependencies
-        run: poetry install --all-extras
+        run: uv sync --all-extras
       - name: "Download coverage artifacts"
         uses: actions/download-artifact@v4
         with:

.github/workflows/ci-lint.yml

@@ -2,6 +2,10 @@
 
 name: lint
 
+env:
+  UV_FROZEN: "1"   # use lock file as is
+  UV_NO_EDITABLE: "1"  # test the build package, not the dev installation
+
 on:
   push:
     branches: [main]
@@ -15,18 +19,14 @@ jobs:
       - uses: actions/checkout@v4
       - name: Setup Env
         uses: ./.github/actions/setup-env
-        with:
-          python-version: "3.13"
-      - name: Install Python dependencies
-        run: poetry install --with dev --no-interaction
       - name: Execute pre-commit handler
         continue-on-error: true
         run: |
-          poetry run pre-commit run check-toml
-          poetry run pre-commit run trailing-whitespace
-          poetry run pre-commit run end-of-file-fixer
-          poetry run pre-commit run ruff
-          poetry run pre-commit run ruff-format
+          uv run pre-commit run check-toml
+          uv run pre-commit run trailing-whitespace
+          uv run pre-commit run end-of-file-fixer
+          uv run pre-commit run ruff
+          uv run pre-commit run ruff-format
       - name: Execute mypy
         run: |
           make mypy-core-report