feat: use uv for project and dependency management

This commit replaces setuptools with uv, standardizing on pyproject.toml to define project
metadata

Major changes include:

- All metadata has been moved from `setup.py` to `pyproject.toml`
- `pyinfra` and `pyinfra_cli` packages now reside inside a `src` folder. The big advantage of this
  is that this separates the code from tests and other files and prevents accidentally referencing
  files that are not packaged when building the project
  See: https://packaging.python.org/en/latest/discussions/src-layout-vs-flat-layout/
- All development commands for testing and linting are now run through `uv run`
- Dependency versions have been redefined using broader version ranges, but are kept to one
  version through a lock file
- Python 3.9 support has been dropped (it will reach EOL 2025-10)
- Python 3.13 support has been added
- Github workflows have been rewritten to use uv
- Package version is now generated from git, using uv-dynamic-versioning

Author: DonDebonair

.flake8

@@ -0,0 +1,17 @@
+[flake8]
+exclude = .git,.venv,build
+ignore = W503,C815,C816,E704,E203,SC
+max-line-length = 100
+
+# flake8-quotes
+inline-quotes = double
+multiline-quotes = double
+docstring-quotes = double
+
+# flake8-import-order
+import-order-style = edited
+application-import-names = pyinfra,pyinfra_cli,docs
+
+# flake8-spellcheck
+whitelist = tests/words.txt
+dictionaries=en_US,python,technical,django

.github/workflows/docs.yml

@@ -15,25 +15,25 @@ jobs:
     if: github.repository == 'pyinfra-dev/pyinfra'
     steps:
       - name: Clone Source Repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Fetch git tags
         run: git fetch --tags origin
 
       - name: Clone Generated Repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           token: ${{ secrets.ACCESS_TOKEN }}
-          repository: fizzadar/docs.pyinfra.com
+          repository: pyinfra-dev/docs.pyinfra.com
           path: docs/public/
 
       - name: Set up Python
         uses: actions/setup-python@v5
 
       - name: Install
         run: |
-          pip install '.[docs]'
-          pip install 'jinja2<3.1'
+          uv sync --group docs --no-default-groups
+          uv pip install 'jinja2<3.1'
 
       - name: Generate documentation
         run: scripts/build-public-docs.sh

.github/workflows/test.yml

@@ -16,67 +16,54 @@ jobs:
   lint:
     runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
-      - run: pip install '.[test]'
-      - run: flake8
+          python-version: "3.13"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+      - run: uv sync --group test --no-default-groups
+      - run: uv run flake8
 
   type-check:
     runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
-      - run: pip install '.[test]'
-      - run: mypy
+          python-version: "3.13"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+      - run: uv sync --group test --no-default-groups
+      - run: uv run mypy
 
   spell-check:
     runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Check spelling
         uses: crate-ci/[email protected]
 
-  # Test instal works on untestable Python versions. This came about because click decided to drop
-  # Python 3.9 support before EOL, so 3.9 was dropped from the unit test matrix. Still need to test
-  # that pyinfra can be built on 3.9.
-  build-legacy-versions:
-    strategy:
-      matrix:
-        python-version: ["3.9"]
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-      - run: pip install '.'
-      - run: pyinfra --help
-
-  # Unit tests
-  #
-
   unit-test:
     needs:
       - lint
       - type-check
     strategy:
       matrix:
         os: [ubuntu-22.04, ubuntu-24.04, macos-13, macos-14, macos-15,windows-2022, windows-2025]
-        python-version: ["3.10", "3.11", "3.12"]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
-      - run: pip install '.[test]'
-      - run: pytest --cov --disable-warnings
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+      - run: uv sync --group test --no-default-groups --python=${{ matrix.python-version }}
+      - run: uv run pytest --cov --disable-warnings
       - name: Upload coverage report to codecov
-        if: ${{ matrix.os == 'ubuntu-24.04' && matrix.python-version == '3.12' }}
+        if: ${{ matrix.os == 'ubuntu-24.04' && matrix.python-version == '3.13' }}
         uses: codecov/codecov-action@v5
 
   # End-to-end tests
@@ -90,28 +77,29 @@ jobs:
       matrix:
         os: [ubuntu-22.04, ubuntu-24.04]
         test-name: [local, ssh, docker, podman]
-        python-version: ["3.10", "3.11", "3.12"]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
         include:
           - os: macos-13
             test-name: local
-            python-version: "3.12"
+            python-version: "3.13"
           - os: macos-14
             test-name: local
-            python-version: "3.12"
+            python-version: "3.13"
           - os: macos-15
             test-name: local
-            python-version: "3.12"
+            python-version: "3.13"
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
-      - run: pip install '.[test]'
-      - run: pytest -m end_to_end_${{ matrix.test-name }}
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+      - run: uv sync --group test --no-default-groups --python=${{ matrix.python-version }}
+      - run: uv run pytest -m end_to_end_${{ matrix.test-name }}
 
   # Finally, single jon to check if all completed, for use in protected branch
-  #
 
   tests-done:
     if: ${{ always() }}

MANIFEST.in

@@ -18,16 +18,19 @@ Third party pull requests help expand pyinfra's functionality and are essential
 
 ## Dev Setup
 
+First, install [uv](https://docs.astral.sh/uv/).
+
+Then, set up a development environment:
+
 ```sh
-# Create a virtualenv with your tool of choice
-# python -m venv / pyenv virtualenv / virtualenv
+# There is no need to create a virtualenv, uv will do that for you
 
 # Clone the repo
 git clone [email protected]:pyinfra-dev/pyinfra.git
 
 # Install the package in editable mode with development requirements
 cd pyinfra
-pip install -e '.[dev]'
+uv sync
 ```
 
 ### Code Style & Type Checking
@@ -54,10 +57,10 @@ To limit the pytests to a specific fact or operation:
 
 ```sh
 # Only run fact tests for facts.efibootmgr.EFIBootMGR
-pytest tests/test_facts.py -k "efibootmgr.EFIBootMGR"
+uv run pytest tests/test_facts.py -k "efibootmgr.EFIBootMGR"
 
 # Only run operation tests for operations.selinux
-pytest tests/test_operations.py -k "selinux."
+uv run pytest tests/test_operations.py -k "selinux."
 ```
 
 #### End to End Tests
@@ -69,11 +72,11 @@ The end to end tests are also executed via `pytest` but not selected by default,
 scripts/dev-test-e2e.sh
 
 # Run local e2e tests (works on Linux / MacOS, no Windows yet)
-pytest -m end_to_end_local
+uv run pytest -m end_to_end_local
 
 # Run Docker and SSH e2e tests (Linux / MacOS with Docker installed)
-pytest -m end_to_end_ssh
-pytest -m end_to_end_docker
+uv run pytest -m end_to_end_ssh
+uv run pytest -m end_to_end_docker
 ```
 
 ## Documentation