Update metadata, migrate to uv, test on 3.14 and free-threaded (#208)

* Update project metadata,

* migrate to uv

* test on 3.14 and free-threaded

* Fix flag for lowest-compat

* Use resolution strategy lowest-direct

* Update contributing guide

* Update RTD build config

Author: amyreese

.github/workflows/ci.yml

@@ -11,58 +11,67 @@ permissions:
   contents: read
 
 env:
-  UV_SYSTEM_PYTHON: 1
+  UV_MANAGED_PYTHON: 1
 
 jobs:
   test:
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: [
+          "3.9",
+          "3.10",
+          "3.11",
+          "3.12",
+          "3.13",
+          "3.13t",
+          "3.14",
+          "3.14t",
+        ]
         os: [macOS-latest, ubuntu-latest, windows-latest]
 
     steps:
       - name: Checkout
         uses: actions/checkout@v5
-      - name: Set Up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v6
+      - uses: astral-sh/setup-uv@v7
         with:
           python-version: ${{ matrix.python-version }}
-          allow-prereleases: true
-      - uses: hynek/setup-cached-uv@v2
-        with:
-          cache-dependency-path: pyproject.toml
-      - name: Install
-        run: make EXTRAS=dev install
+      - run: uv sync
       - name: Test
         run: make test
       - name: Lint
         run: make lint
 
-  build:
-    needs: test
+  compat:
+    env:
+      UV_RESOLUTION: lowest-direct
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
-      - uses: actions/setup-python@v6
+      - uses: astral-sh/setup-uv@v7
         with:
-          python-version: '3.12'
-      - uses: hynek/setup-cached-uv@v2
+          python-version: "3.9"
+      - run: uv sync
+      - run: make test lint
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
         with:
-          cache-dependency-path: pyproject.toml
-      - name: Install
-        run: make install
-      - name: Build
-        run: python -m build
+          python-version: "3.14"
+      - run: uv sync
+      - run: uv build
       - name: Upload
         uses: actions/upload-artifact@v5
         with:
           name: sdist
           path: dist
-  
+
   publish:
-    needs: build
+    needs: [build, compat, test]
     runs-on: ubuntu-latest
     if: startsWith(github.ref, 'refs/tags/v')
     permissions:

.gitignore

@@ -1,3 +1,4 @@
+uv.lock
 html/
 
 # Byte-compiled / optimized / DLL files

.readthedocs.yml

@@ -2,12 +2,10 @@ version: 2
 sphinx:
   configuration: docs/conf.py
 build:
-  os: ubuntu-22.04
+  os: ubuntu-24.04
   tools:
-    python: "3.10"
-python:
-  install:
-    - method: pip
-      path: .
-      extra_requirements:
-        - docs
+    python: "3.13"
+  jobs:
+    install:
+      - pip install --upgrade pip
+      - pip install --group 'docs'

CONTRIBUTING.md

@@ -2,23 +2,27 @@
 
 ## Preparation
 
-You'll need to have Python 3.8 or newer available for testing.
-I recommend using [pyenv][] for this:
+aioitertools uses [uv][] to manage environments and dependencies, and `make`
+to run tests and linters.
+
+You'll need to have Python 3.9 or newer available for testing:
 
 ```sh
-$ pyenv install 3.12
-$ pyenv shell 3.12
+$ uv python pin 3.14
 ```
 
-## Setup
+## Testing
 
-Create a fresh development enviroment, and install the
-appropriate tools and dependencies:
+Run the test suite:
 
-```sh
-$ cd <path/to/aioitertools>
-$ make venv
-$ source .venv/bin/activate
+```shell-session
+$ make test
+```
+
+Run the linters:
+
+```shell-session
+$ make lint
 ```
 
 ## Submitting
@@ -32,4 +36,4 @@ that you have done the following:
 * Used `make format` to format code appropriately
 * Validated and tested code with `make test lint`
 
-[pyenv]: https://github.com/pyenv/pyenv
+[uv]: https://docs.astral.sh/uv/

README.md

@@ -12,7 +12,7 @@ Implementation of itertools, builtins, and more for AsyncIO and mixed-type itera
 Install
 -------
 
-aioitertools requires Python 3.8 or newer.
+aioitertools requires Python 3.9 or newer.
 You can install it from PyPI:
 
 ```sh

makefile

@@ -1,45 +1,24 @@
 PKG:=aioitertools
-EXTRAS:=dev,docs
 
-UV:=$(shell uv --version)
-ifdef UV
-	VENV:=uv venv
-	PIP:=uv pip
-else
-	VENV:=python -m venv
-	PIP:=python -m pip
-endif
-
-.venv:
-	$(VENV) .venv
-
-venv: .venv
-	source .venv/bin/activate && make install
-	echo 'run `source .venv/bin/activate` to use virtualenv'
-
-install:
-	$(PIP) install -Ue .[$(EXTRAS)]
-
-release: lint test clean
-	flit publish
+all: format test lint
 
 format:
-	python -m ufmt format $(PKG)
+	uv run ufmt format $(PKG)
 
 lint:
-	python -m flake8 $(PKG)
-	python -m ufmt check $(PKG)
+	uv run flake8 $(PKG)
+	uv run ufmt check $(PKG)
 
 test:
-	python -m coverage run -m $(PKG).tests
-	python -m coverage report
-	python -m mypy -p $(PKG)
+	uv run coverage run -m $(PKG).tests
+	uv run coverage report
+	uv run mypy -p $(PKG)
 
 html: .venv README.md docs/*
-	source .venv/bin/activate && sphinx-build -b html docs html
+	uv run --group docs sphinx-build -b html docs html
 
 clean:
-	rm -rf .mypy_cache build dist html README MANIFEST *.egg-info
+	rm -rf .mypy_cache uv.lock build dist html README MANIFEST *.egg-info
 
 distclean: clean
 	rm -rf .venv

pyproject.toml

@@ -1,28 +1,26 @@
 [build-system]
-requires = ["flit_core >=3.8,<4"]
+requires = ["flit_core >=3.11,<4"]
 build-backend = "flit_core.buildapi"
 
 [project]
 name = "aioitertools"
 readme = "README.md"
 authors = [{ name = "Amethyst Reese", email = "amethyst@n7.gg" }]
-license = { file = "LICENSE" }
+license = "MIT"
+license-files = ["LICENSE"]
 dynamic = ["version", "description"]
 classifiers = [
-    "Development Status :: 4 - Beta",
     "Framework :: AsyncIO",
     "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
     "Topic :: Software Development :: Libraries",
 ]
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 dependencies = ["typing_extensions>=4.0; python_version < '3.10'"]
 
-[project.optional-dependencies]
+[dependency-groups]
 dev = [
     "attribution==1.8.0",
     "black==24.8.0",
-    "build>=1.2",
     "coverage==7.6.1",
     "flake8==7.1.1",
     "flit==3.9.0",
@@ -37,6 +35,7 @@ docs = [
 
 [project.urls]
 Documentation = "https://aioitertools.omnilib.dev"
+Changelog = "https://aioitertools.omnilib.dev/en/latest/changelog.html"
 Github = "https://github.com/omnilib/aioitertools"
 
 [tool.flit.sdist]
@@ -62,3 +61,6 @@ skip_covered = true
 [tool.mypy]
 # strict = true
 ignore_missing_imports = true
+
+[tool.uv.dependency-groups]
+docs = {requires-python=">=3.10"}