Switch to uv for dependency management (#1788)

- use `uv` to lock dependencies, but still export them to
`requirements.txt` files so the CI is not changed.
 - Bump supported Python to 3.11 (NEP 29)

xref #1807

Author: mpharrigan

.github/workflows/nightly.yaml

@@ -36,7 +36,7 @@ jobs:
       - uses: ts-graphviz/setup-graphviz@c001ccfb5aff62e28bda6a6c39b59a7e061be5b9 # v1
       - uses: actions/setup-python@42375524e23c412d93fb67b49958b491fce71c38 # v5
         with:
-          python-version: "3.10"
+          python-version: "3.11"
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip

.github/workflows/pr.yaml

@@ -34,7 +34,7 @@ jobs:
       - uses: ts-graphviz/setup-graphviz@c001ccfb5aff62e28bda6a6c39b59a7e061be5b9 # v1
       - uses: actions/setup-python@42375524e23c412d93fb67b49958b491fce71c38 # v5
         with:
-          python-version: "3.10"
+          python-version: "3.11"
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
@@ -51,7 +51,7 @@ jobs:
       - uses: ts-graphviz/setup-graphviz@c001ccfb5aff62e28bda6a6c39b59a7e061be5b9 # v1
       - uses: actions/setup-python@42375524e23c412d93fb67b49958b491fce71c38 # v5
         with:
-          python-version: "3.10"
+          python-version: "3.11"
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
@@ -69,7 +69,7 @@ jobs:
       - uses: ts-graphviz/setup-graphviz@c001ccfb5aff62e28bda6a6c39b59a7e061be5b9 # v1
       - uses: actions/setup-python@42375524e23c412d93fb67b49958b491fce71c38 # v5
         with:
-          python-version: "3.10"
+          python-version: "3.11"
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
@@ -89,7 +89,7 @@ jobs:
           fetch-depth: 0
       - uses: actions/setup-python@42375524e23c412d93fb67b49958b491fce71c38 # v5
         with:
-          python-version: "3.10"
+          python-version: "3.11"
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
@@ -109,7 +109,7 @@ jobs:
           fetch-depth: 0
       - uses: actions/setup-python@42375524e23c412d93fb67b49958b491fce71c38 # v5
         with:
-          python-version: "3.10"
+          python-version: "3.11"
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
@@ -129,7 +129,7 @@ jobs:
           fetch-depth: 0
       - uses: actions/setup-python@42375524e23c412d93fb67b49958b491fce71c38 # v5
         with:
-          python-version: "3.10"
+          python-version: "3.11"
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
@@ -148,7 +148,7 @@ jobs:
       - uses: ts-graphviz/setup-graphviz@c001ccfb5aff62e28bda6a6c39b59a7e061be5b9 # v1
       - uses: actions/setup-python@42375524e23c412d93fb67b49958b491fce71c38 # v5
         with:
-          python-version: "3.10"
+          python-version: "3.11"
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip

MANIFEST.in

@@ -7,7 +7,7 @@
 Python package for fault-tolerant quantum algorithms research.
 
 [![Licensed under the Apache 2.0 open-source license](https://img.shields.io/badge/License-Apache%202.0-3c60b1.svg?logo=opensourceinitiative\&logoColor=white\&style=flat-square)](https://github.com/quantumlib/qualtran/blob/main/LICENSE)
-[![Compatible with Python versions 3.10 and higher](https://img.shields.io/badge/Python-3.10+-6828b2.svg?style=flat-square&logo=python&logoColor=white)](https://www.python.org/downloads/)
+[![Compatible with Python versions 3.11 and higher](https://img.shields.io/badge/Python-3.11+-6828b2.svg?style=flat-square&logo=python&logoColor=white)](https://www.python.org/downloads/)
 [![Qualtran project on PyPI](https://img.shields.io/pypi/v/qualtran.svg?logo=python&logoColor=white&label=PyPI&style=flat-square&color=9d3bb8)](https://pypi.org/project/qualtran)
 
 [Installation](#installation) –

README.md

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 name = "qualtran-dev-tools"
 version = "0.1.0"
 description = "Local development tools for the Qualtran project."
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 
 [tool.setuptools]
 packages = ["qualtran_dev_tools"]

dev_tools/pyproject.toml

@@ -0,0 +1,8 @@
+We use `uv` to manage dependencies.
+
+ - From the project's root directory, run `uv lock` to pin the versions of all transitive
+   dependencies in the uv.lock file.
+ - Run `uv lock -U` to upgrade the pinned versions.
+ - Run `uv sync --frozen --no-dev [--group test/typing/lint/..]` to install the pinned dependencies.
+ - You can use `export-from-uv-lock.sh` in this directory to output legacy requirements.txt
+   environment files.

dev_tools/requirements/Dockerfile

@@ -0,0 +1,3 @@
+This directory use to contain "factored out" dependencies, with one dependency group per file.
+The Python packaging ecosystem now has better support for dependency groups through `uv`,
+ so please find the dependency groups in pyproject.toml.