Migrate project configuration to pyproject.toml and uv (#455)

Author: achimnol

.github/workflows/ci-cd.yml

@@ -15,8 +15,6 @@ on:  # yamllint disable-line rule:truthy
 
 env:
   FORCE_COLOR: "1"  # Make tools pretty.
-  PIP_DISABLE_PIP_VERSION_CHECK: "1"
-  PIP_NO_PYTHON_VERSION_WARNING: "1"
   PYTHON_LATEST: "3.13"
 
   # For re-actors/checkout-python-sdist
@@ -33,15 +31,12 @@ jobs:
       uses: actions/checkout@v6
       with:
         fetch-depth: 0
-    - name: Set up Python
-      uses: actions/setup-python@v6
+    - name: Install uv and Python
+      uses: astral-sh/setup-uv@v5
       with:
         python-version: ${{ env.PYTHON_LATEST }}
-        cache: pip
-    - run: python -m pip install build
-      name: Install core libraries for build and install
     - name: Build artifacts
-      run: python -m build
+      run: uv build
     - name: Upload built artifacts for testing
       uses: actions/upload-artifact@v6
       with:
@@ -65,33 +60,27 @@ jobs:
       fail-fast: true
       matrix:
         python-version:
-        - "3.9"
         - "3.10"
         - "3.11"
         - "3.12"
         - "3.13"
         experimental: [false]
         # include:
-        # - python-version: "~3.12.0-0"
+        # - python-version: "~3.14.0-0"
         #   experimental: true
     steps:
     - name: Checkout the source code
       uses: actions/checkout@v6
       with:
         fetch-depth: 0
-    - name: Set up Python
-      uses: actions/setup-python@v6
+    - name: Install uv and Python
+      uses: astral-sh/setup-uv@v5
       with:
         python-version: ${{ matrix.python-version }}
-        cache: pip
-        cache-dependency-path: |
-          setup.cfg
-          requirements-dev.txt
     - name: Install dependencies
-      run: |
-        pip install -U -r requirements-dev.txt
+      run: uv sync --group dev
     - name: Run tests
-      run: python -m pytest --cov=aiomonitor -v tests
+      run: uv run pytest --cov=aiomonitor -v tests
     - name: Upload coverage data
       uses: codecov/codecov-action@v5
 

.github/workflows/lint.yml

@@ -8,8 +8,6 @@ on:  # yamllint disable-line rule:truthy
 
 env:
   FORCE_COLOR: "1"  # Make tools pretty.
-  PIP_DISABLE_PIP_VERSION_CHECK: "1"
-  PIP_NO_PYTHON_VERSION_WARNING: "1"
   PYTHON_LATEST: "3.11"
 
 jobs:
@@ -22,21 +20,14 @@ jobs:
       uses: actions/checkout@v6
       with:
         fetch-depth: 0
-    - name: Set up Python
-      uses: actions/setup-python@v6
+    - name: Install uv and Python
+      uses: astral-sh/setup-uv@v5
       with:
         python-version: ${{ env.PYTHON_LATEST }}
-        check-latest: true
-        cache: pip
-        cache-dependency-path: |
-          setup.cfg
-          requirements-dev.txt
     - name: Install dependencies
-      run: |
-        pip install -U -r requirements-dev.txt
+      run: uv sync --group dev
     - name: Lint with Ruff
-      run: |
-        python -m ruff check
+      run: uv run ruff check
 
   typecheck-mypy:
     name: Check typing and annotations
@@ -46,19 +37,13 @@ jobs:
       uses: actions/checkout@v6
       with:
         fetch-depth: 0
-    - name: Set up Python
-      uses: actions/setup-python@v6
+    - name: Install uv and Python
+      uses: astral-sh/setup-uv@v5
       with:
         python-version: ${{ env.PYTHON_LATEST }}
-        check-latest: true
-        cache: pip
-        cache-dependency-path: |
-          setup.cfg
-          requirements-dev.txt
     - name: Install dependencies
-      run: |
-        pip install -U -r requirements-dev.txt
+      run: uv sync --group dev
     - name: Typecheck with mypy
       run: |
         echo "::add-matcher::.github/workflows/mypy-matcher.json"
-        python -m mypy aiomonitor/ examples/ tests/
+        uv run mypy aiomonitor/ examples/ tests/

.readthedocs.yml

@@ -13,12 +13,18 @@ sphinx:
 formats: []
 
 build:
-  os: ubuntu-20.04
+  os: ubuntu-24.04
   tools:
     python: >-  # PyYAML parses it as float but RTD demands an explicit string
-      3.11
-python:
-  install:
-  - method: pip
-    path: .
-  - requirements: requirements-doc.txt
+      3.13
+  jobs:
+    pre_create_environment:
+    - asdf plugin add uv
+    - asdf install uv latest
+    - asdf global uv latest
+    create_environment:
+    - uv venv "${READTHEDOCS_VIRTUALENV_PATH}"
+    install:
+    - >-
+      UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}"
+      uv sync --frozen --group doc

MANIFEST.in

@@ -0,0 +1 @@
+Migrated project configuration to pyproject.toml and uv, consolidating setup.cfg metadata, replacing pip with uv in CI workflows and ReadTheDocs, and updating the minimum Python version to 3.10

changes/454.enhancement

@@ -2,9 +2,90 @@
 requires = ["setuptools>=69.2", "setuptools_scm[toml]>=8.0"]
 build-backend = "setuptools.build_meta"
 
+[project]
+name = "aiomonitor"
+dynamic = ["version", "readme"]
+description = "Adds monitor and Python REPL capabilities for asyncio applications"
+keywords = ["asyncio", "aiohttp", "monitor", "debugging", "utility", "devtool"]
+license = "Apache-2.0"
+authors = [
+    {name = "Nikolay Novik", email = "nickolainovik@gmail.com"},
+]
+maintainers = [
+    {name = "Joongi Kim", email = "me@daybreaker.info"},
+]
+classifiers = [
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: POSIX",
+    "Development Status :: 3 - Alpha",
+    "Framework :: AsyncIO",
+]
+requires-python = ">=3.10"
+dependencies = [
+    "attrs>=20",
+    "aiohttp>=3.8.5",
+    "click>=8.0",
+    "janus>=1.0",
+    "jinja2>=3.1.2",
+    "backports.strenum>=1.2.4; python_version<'3.11'",
+    "terminaltables",
+    "pydantic>=2.0.0",
+    "typing-extensions>=4.1",
+    "prompt_toolkit>=3.0",
+    "aioconsole>=0.7.0",
+    "telnetlib3>=2.0.4",
+]
+
+[project.urls]
+Homepage = "https://github.com/aio-libs/aiomonitor"
+Documentation = "https://aiomonitor.readthedocs.io"
+Repository = "https://github.com/aio-libs/aiomonitor"
+Issues = "https://github.com/aio-libs/aiomonitor/issues"
+Changelog = "https://github.com/aio-libs/aiomonitor/blob/main/CHANGES.rst"
+Chat = "https://matrix.to/#/!aio-libs:matrix.org"
+
+[dependency-groups]
+dev = [
+    "aioconsole==0.8.2",
+    "aiohttp==3.10.10",
+    "aiotools==1.7.0",
+    "attrs==24.2.0",
+    "build==1.3.0",
+    "docutils==0.21.2",
+    "ipdb==0.13.13",
+    "mypy==1.18.2",
+    "pre-commit==3.5.0",
+    "pytest==8.3.3",
+    "pytest-asyncio==0.24.0",
+    "pytest-cov==7.0.0",
+    "pytest-sugar==1.1.1",
+    "ruff==0.14.2",
+    "terminaltables==3.1.10",
+    "towncrier==24.8.0",
+    "types-requests",
+    "telnetlib3==2.0.4",
+    "uvloop==0.21.0",
+]
+doc = [
+    "sphinx~=7.2",
+    "sphinx-click~=5.1.0",
+    "sphinx-autodoc-typehints~=1.25",
+]
+
 [tool.setuptools_scm]
 # enables setuptools_scm to provide the dynamic version
 
+[tool.setuptools.dynamic]
+readme = {file = ["README.rst", "CHANGES.rst"], content-type = "text/x-rst"}
+
+[tool.setuptools.packages.find]
+exclude = ["examples*", "tools*"]
+
 [tool.ruff]
 line-length = 88
 src = ["aiomonitor", "tests", "examples"]