feat!: pystac v2

.github/workflows/continuous-integration.yml

@@ -4,31 +4,23 @@ on:
   push:
     branches:
       - main
-      - "0.3"
-      - "0.4"
-      - "0.5"
-      - "1.0"
-      - "2.0"
   pull_request:
   merge_group:
 
 concurrency:
   group: ${{ github.ref }}
   cancel-in-progress: true
 
-permissions: {}
-
 jobs:
   test:
     name: test
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
         python-version:
-          - "3.10"
-          - "3.11"
           - "3.12"
           - "3.13"
+          - "3.14"
         os:
           - ubuntu-latest
           - windows-latest
@@ -38,22 +30,21 @@ jobs:
       - uses: astral-sh/setup-uv@61cb8a9741eeb8a550a1b8544337180c0fc8476b # v7.2.0
         with:
           python-version: ${{ matrix.python-version }}
-      - name: Sync
-        run: uv sync --all-extras
-      - name: Lint
-        if: runner.os != 'Windows'
-        run: uv run pre-commit run --all-files
+      # - name: Lint
+      #   if: runner.os != 'Windows'
+      #   run: uv run prek run --all-files
       - name: Test on windows
         if: runner.os == 'Windows'
         shell: bash
         env:
           TMPDIR: 'D:\\a\\_temp'
-        run: uv run pytest tests
+        run: uv run pytest tests --block-network --record-mode=none
       - name: Test
         if: runner.os != 'Windows'
         run: uv run pytest tests --block-network --record-mode=none
 
   coverage:
+    if: false  # exclude on pystac v2 for now
     name: coverage
     runs-on: ubuntu-latest
     permissions:
@@ -64,11 +55,7 @@ jobs:
       - name: Install with dependencies
         run: uv sync --all-extras
       - name: Run coverage with orjson
-        run: uv run pytest tests --cov
-      - name: Uninstall orjson
-        run: uv pip uninstall orjson
-      - name: Run coverage without orjson, appending results
-        run: uv run pytest tests --cov --cov-append
+        run: uv run --all-extras pytest tests --cov
       - 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
@@ -86,6 +73,7 @@ jobs:
         run: uv run coverage report
 
   without-orjson:
+    if: false  # exclude on pystac v2 for now
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
@@ -101,6 +89,7 @@ jobs:
     # This checks to make sure any API changes haven't broken any of the
     # benchmarks. It doesn't do any actual benchmarking, since (IMO) that's not
     # appropriate for CI on GitHub actions.
+    if: false  # exclude on pystac v2 for now
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
@@ -119,6 +108,7 @@ jobs:
 
   docs:
     runs-on: ubuntu-latest
+    if: false  # exclude on pystac v2 for now
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
       - uses: astral-sh/setup-uv@61cb8a9741eeb8a550a1b8544337180c0fc8476b # v7.2.0

.github/workflows/docs.yml

@@ -0,0 +1,42 @@
+name: Docs
+
+on:
+  push:
+    branches:
+      - main
+      - v2 # FIXME: remove before mergin
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build documentation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8
+      - uses: astral-sh/setup-uv@681c641aba71e4a1c380be3ab5e12ad51f415867
+      - uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b
+      - name: Build docs
+        run: uv run mkdocs build --strict
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa
+        with:
+          path: ./site
+
+  deploy:
+    name: Deploy to GitHub Pages
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e

.github/workflows/pr.yml

@@ -7,15 +7,13 @@ on:
       - edited
       - reopened
 
-permissions: {}
-
 jobs:
   lint:
     name: Lint
     runs-on: ubuntu-latest
     permissions:
       pull-requests: read
     steps:
-      - uses: amannn/action-semantic-pull-request@48f256284bd46cdaab1048c3721360e808335d50 # v6.1.1
+      - uses: amannn/action-semantic-pull-request@48f256284bd46cdaab1048c3721360e808335d50
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/release-please.yml

@@ -16,12 +16,12 @@ jobs:
     outputs:
       prs: ${{ steps.release-please.outputs.prs }}
     steps:
-      - uses: actions/create-github-app-token@29824e69f54612133e76f7eaac726eef6c875baf # v2.2.1
+      - uses: actions/create-github-app-token@29824e69f54612133e76f7eaac726eef6c875baf
         id: generate-token
         with:
           app-id: ${{ vars.RELEASE_BOT_CLIENT_ID }}
           private-key: ${{ secrets.RELEASE_BOT_PRIVATE_KEY }}
-      - uses: googleapis/release-please-action@16a9c90856f42705d54a6fda1823352bdc62cf38 # v4.4.0
+      - uses: googleapis/release-please-action@16a9c90856f42705d54a6fda1823352bdc62cf38
         id: release-please
         with:
           token: ${{ steps.generate-token.outputs.token }}
@@ -32,7 +32,7 @@ jobs:
     needs: release-please
     if: ${{ needs.release-please.outputs.prs }}
     steps:
-      - uses: actions/create-github-app-token@29824e69f54612133e76f7eaac726eef6c875baf # v2.2.1
+      - uses: actions/create-github-app-token@29824e69f54612133e76f7eaac726eef6c875baf
         id: generate-token
         with:
           app-id: ${{ vars.RELEASE_BOT_CLIENT_ID }}

.github/workflows/release.yml

@@ -5,8 +5,6 @@ on:
     types:
       - published
 
-permissions: {}
-
 jobs:
   release:
     name: release
@@ -27,7 +25,7 @@ jobs:
         run: |
           python -m pip install --upgrade pip
           pip install build
-      - name: Build 
+      - name: Build
         run: python -m build
       - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e # v1.13.0
+        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e

.pre-commit-config.yaml

@@ -1,50 +1,19 @@
-# Configuration file for pre-commit (https://pre-commit.com/).
-# Please run `pre-commit run --all-files` when adding or changing entries.
-
 repos:
-  - repo: https://github.com/asottile/pyupgrade
-    rev: v3.19.1
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.1
     hooks:
-      - id: pyupgrade
-        args:
-          - "--py310-plus"
-
-  - repo: local
+      - id: codespell
+        types_or:
+          - jupyter
+          - markdown
+          - python
+          - shell
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.9
     hooks:
-      - id: ruff
-        name: ruff
-        entry: ruff check --force-exclude --fix --exit-non-zero-on-fix
-        language: system
-        types_or: [python, pyi, jupyter]
-        require_serial: true
-
+      - id: ruff-check
       - id: ruff-format
-        name: ruff-format
-        entry: ruff format --force-exclude
-        language: system
-        stages: [pre-commit]
-        types_or: [python, pyi, jupyter]
-        require_serial: true
-
-      - id: codespell
-        name: codespell
-        entry: codespell
-        language: system
-        stages: [pre-commit]
-        types_or: [jupyter, markdown, python, shell]
-
-      - id: doc8
-        name: doc8
-        entry: doc8
-        language: system
-        files: \.rst$
-        require_serial: true
-
-      - id: mypy
-        name: mypy
-        entry: mypy
-        args: [--no-incremental]
-        language: system
-        stages: [pre-commit]
-        types: [python]
-        require_serial: true
+  - repo: https://github.com/DetachHead/basedpyright-prek-mirror
+    rev: 1.36.1
+    hooks:
+      - id: basedpyright

.python-version

@@ -1 +1 @@
-3.10
+3.12

.readthedocs.yaml

@@ -7,20 +7,19 @@ version: 2
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.10"
+    python: "3.12"
   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 --group docs
-    - uv run sphinx-build -T -b html -d docs/_build/doctrees -D language=en docs $READTHEDOCS_OUTPUT/html
+    - uv run mkdocs build --site-dir $READTHEDOCS_OUTPUT/html
 
 formats:
-  # Temporarily disabling PDF downloads due to problem with nbsphinx in LateX builds
-  # - pdf
   - htmlzip
 
-sphinx:
+mkdocs:
+  configuration: mkdocs.yml
   fail_on_warning: false