feat: use uv

Author: gadomski

.github/workflows/continuous-integration.yml

@@ -22,32 +22,28 @@ jobs:
     name: test
     runs-on: ${{ matrix.os }}
     strategy:
-      # Allow other matrix jobs to complete if 1 fails
-      fail-fast: false
       matrix:
         python-version:
           - "3.10"
           - "3.11"
           - "3.12"
+          - "3.13"
         os:
           - ubuntu-latest
           - windows-latest
           - macos-latest
-
     steps:
       - uses: actions/checkout@v4
-
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+      - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
-          cache: "pip"
-
-      - name: Install dependencies
-        run: pip install .[validation] -r requirements-dev.txt
-
-      - name: Execute test suite
-        run: ./scripts/test
+      - uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Sync
+        run: uv sync --all-extras
+      - name: test
+        run: source .venv/bin/activate && ./scripts/test
         shell: bash
         env:
           TMPDIR: "${{ matrix.os == 'windows-latest' && 'D:\\a\\_temp' || '' }}"
@@ -57,38 +53,31 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-
-      - name: Set up Python 3.10
-        uses: actions/setup-python@v5
+      - uses: actions/setup-python@v5
         with:
           python-version: "3.10"
-          cache: "pip"
-
+      - uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
       - name: Install with dependencies
-        run: pip install .[validation] -r requirements-dev.txt
-
+        run: uv sync --all-extras
       - name: Run coverage with orjson
-        run: pytest tests --cov
-
+        run: uv run pytest tests --cov
       - name: Uninstall orjson
-        run: pip uninstall -y orjson
-
+        run: uv pip uninstall -y orjson
       - name: Run coverage without orjson, appending results
-        run: pytest tests --cov --cov-append
-
+        run: uv run pytest tests --cov --cov-append
       - name: Prepare ./coverage.xml
         # Ignore the configured fail-under to ensure we upload the coverage report. We
         # will trigger a failure for coverage drops in a later job
-        run: coverage xml --fail-under 0
-
+        run: uv run coverage xml --fail-under 0
       - name: Upload All coverage to Codecov
         uses: codecov/codecov-action@v4
         if: ${{ env.GITHUB_REPOSITORY }} == 'stac-utils/pystac'
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           file: ./coverage.xml
           fail_ci_if_error: false
-
       - name: Check for coverage drop
         # This will use the configured fail-under, causing this job to fail if the
         # coverage drops.
@@ -97,59 +86,41 @@ jobs:
   lint:
     runs-on: ubuntu-latest
     strategy:
-      # Allow other matrix jobs to complete if 1 fails
-      fail-fast: false
       matrix:
         python-version:
           - "3.10"
           - "3.11"
           - "3.12"
-
+          - "3.13"
     steps:
       - uses: actions/checkout@v4
-
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+      - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
-          cache: "pip"
-
-      - name: Install with test dependencies
-        run: pip install . -r requirements-dev.txt
-
+      - uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Sync
+        run: uv sync
       - name: Execute linters & type checkers
-        run: pre-commit run --all-files
+        run: uv pre-commit run --all-files
 
   without-orjson:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-
       - uses: actions/setup-python@v5
         with:
           python-version: "3.10"
-
-      - name: Install
-        run: pip install .[validation] -r requirements-dev.txt
-
+      - uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Sync
+        run: uv sync
       - name: Uninstall orjson
-        run: pip uninstall -y orjson
-
+        run: uv pip uninstall -y orjson
       - name: Run tests
-        run: pytest tests
-
-  check-all-dependencies:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.10"
-          cache: "pip"
-
-      - name: Install all dependencies
-        run: pip install .[orjson,urllib3,validation,jinja2]
+        run: uv run pytest tests
 
   check-benchmarks:
     # This checks to make sure any API changes haven't broken any of the
@@ -161,9 +132,11 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: "3.10"
-          cache: "pip"
-      - name: Install pystac
-        run: pip install . -r requirements-dev.txt
+      - uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Sync
+        run: uv sync
       - name: Set asv machine
         run: asv machine --yes
       - name: Check benchmarks
@@ -176,10 +149,12 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: "3.10"
-          cache: "pip"
+      - uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
       - name: Install pandoc
         run: sudo apt-get install pandoc
       - name: Install pystac
-        run: pip install . -r docs/requirements-docs.txt
+        run: uv sync --no-dev && uv sync --package docs --inexact
       - name: Check docs
         run: make -C docs html SPHINXOPTS="-W --keep-going"

.pre-commit-config.yaml

@@ -3,7 +3,7 @@
 
 repos:
   - repo: https://github.com/asottile/pyupgrade
-    rev: v3.17.0
+    rev: v3.18.0
     hooks:
       - id: pyupgrade
         args:
@@ -22,15 +22,15 @@ repos:
         name: ruff-format
         entry: ruff format --force-exclude
         language: system
-        stages: [commit]
+        stages: [pre-commit]
         types_or: [python, pyi, jupyter]
         require_serial: true
 
       - id: codespell
         name: codespell
         entry: codespell
         language: system
-        stages: [commit]
+        stages: [pre-commit]
         types_or: [jupyter, markdown, python, shell]
 
       - id: doc8
@@ -45,6 +45,6 @@ repos:
         entry: mypy
         args: [--no-incremental]
         language: system
-        stages: [commit]
+        stages: [pre-commit]
         types: [python]
         require_serial: true

.readthedocs.yaml

@@ -8,17 +8,20 @@ build:
   os: ubuntu-22.04
   tools:
     python: "3.10"
+  commands:
+    # https://docs.readthedocs.io/en/stable/build-customization.html#install-dependencies-with-uv
+    # with adaptations to use workspaces+projects instead of `uv pip`
+    - asdf plugin add uv
+    - asdf install uv latest
+    - asdf global uv latest
+    - uv sync uv --all-extras --no-dev
+    - uv sync --package pystac-docs --inexact # we need inexact to keep the top-level sync packages 
+    - uv run sphinx-build -T -b html -d docs/_build/doctrees -D language=en docs $READTHEDOCS_OUTPUT/html
 
 formats:
   # Temporarily disabling PDF downloads due to problem with nbsphinx in LateX builds
   # - pdf
   - htmlzip
 
-python:
-  install:
-    - requirements: docs/requirements-docs.txt
-    - method: pip
-      path: .
-
 sphinx:
   fail_on_warning: false

README.md

@@ -15,46 +15,46 @@ PySTAC is a library for working with the [SpatioTemporal Asset Catalog](https://
 ### Install from PyPi (recommended)
 
 ```shell
-pip install pystac
+python -m pip install pystac
 ```
 
 If you would like to enable the validation feature utilizing the
 [jsonschema](https://pypi.org/project/jsonschema/) project, install with the optional
 `validation` requirements:
 
 ```shell
-pip install 'pystac[validation]'
+python -m pip install 'pystac[validation]'
 ```
 
 If you would like to use the [`orjson`](https://pypi.org/project/orjson/) instead of the
 standard `json` library for JSON serialization/deserialization, install with the
 optional `orjson` requirements:
 
 ```shell
-pip install 'pystac[orjson]'
+python -m pip install 'pystac[orjson]'
 ```
 
 If you would like to use a custom `RetryStacIO` class for automatically retrying
 network requests when reading with PySTAC, you'll need
 [`urllib3`](https://urllib3.readthedocs.io/en/stable/):
 
 ```shell
-pip install 'pystac[urllib3]'
+python -m pip install 'pystac[urllib3]'
 ```
 
 If you are using jupyter notebooks and want to enable pretty display of pystac
 objects you'll need [`jinja2`](https://pypi.org/project/Jinja2/)
 
 ```shell
-pip install 'pystac[jinja2]'
+python -m pip install 'pystac[jinja2]'
 ```
 
 ### Install from source
 
 ```shell
 git clone https://github.com/stac-utils/pystac.git
 cd pystac
-pip install .
+python -m pip install .
 ```
 
 See the [installation page](https://pystac.readthedocs.io/en/latest/installation.html)

docs/contributing.rst

@@ -8,13 +8,14 @@ way is to coordinate with the core developers via an issue or pull request conve
 Development installation
 ^^^^^^^^^^^^^^^^^^^^^^^^
 Fork PySTAC into your GitHub account. Then, clone the repo and install it locally with
-pip as follows:
+`uv <https://docs.astral.sh/uv/getting-started/installation/>` as follows:
 
 .. code-block:: bash
 
     git clone [email protected]:your_user_name/pystac.git
     cd pystac
-    pip install -e . -r requirements-dev.txt
+    uv sync
+    source .venv/bin/activate
 
 Testing
 ^^^^^^^

docs/pyproject.toml

@@ -0,0 +1,19 @@
+[project]
+name = "pystac-docs"
+version = "0.0.0"
+description = "This package is only for uv, so it can share a lockfile with the top-level project. It should never be published"
+requires-python = ">=3.10"
+dependencies = [
+    "boto3>=1.35.39",
+    "ipython>=8.28.0",
+    "jinja2>=3.1.4",
+    "jupyter>=1.1.1",
+    "nbsphinx>=0.9.5",
+    "pydata-sphinx-theme>=0.15.4",
+    "rasterio>=1.4.1",
+    "shapely>=2.0.6",
+    "sphinx>=8.1.1",
+    "sphinx-autobuild>=2024.10.3",
+    "sphinx-design>=0.6.1",
+    "sphinxcontrib-fulltoc>=1.2.0",
+]