Workspace Support

.github/workflows/build-hatch.yml

@@ -51,7 +51,7 @@ jobs:
       run: |-
         uv pip install --system build
         uv pip install --system .
-        uv pip install --system ./backend
+        hatch env create
 
     # Windows installers don't accept non-integer versions so we ubiquitously
     # perform the following transformation: X.Y.Z.devN -> X.Y.Z.N
@@ -166,7 +166,7 @@ jobs:
     - name: Install Hatch
       run: |-
         uv pip install --system -e .
-        uv pip install --system -e ./backend
+        hatch env create
 
     - name: Install Rust toolchain
       uses: dtolnay/rust-toolchain@stable

.github/workflows/cli.yml

@@ -43,7 +43,6 @@ jobs:
     - name: Install ourself
       run: |
         uv pip install --system .
-        uv pip install --system ./backend
 
     - name: Benchmark
       run: |

.github/workflows/docs-dev.yml

@@ -38,7 +38,7 @@ jobs:
     - name: Install ourself
       run: |
         uv pip install --system -e .
-        uv pip install --system -e ./backend
+        hatch env create
 
     - name: Configure Git for GitHub Actions bot
       run: |

.github/workflows/docs-release.yml

@@ -36,7 +36,7 @@ jobs:
     - name: Install ourself
       run: |
         uv pip install --system -e .
-        uv pip install --system -e ./backend
+        hatch env create     
 
     - name: Display full version
       run: hatch version

.github/workflows/test.yml

@@ -24,125 +24,125 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
 
     steps:
-    - uses: actions/checkout@v4
+      - uses: actions/checkout@v4
 
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
-      with:
-        python-version: ${{ matrix.python-version }}
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
 
-    - name: Install uv
-      uses: astral-sh/setup-uv@v3
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
 
-    - name: Install ourself
-      run: |
-        uv pip install --system -e .
-        uv pip install --system -e ./backend
+      - name: Install ourself
+        run: |
+          uv pip install --system -e .
+          hatch env create
 
-    - name: Run static analysis
-      run: hatch fmt --check
+      - name: Run static analysis
+        run: hatch fmt --check
 
-    - name: Check types
-      run: hatch run types:check
+      - name: Check types
+        run: hatch run types:check
 
-    - name: Run tests
-      run: hatch test --python ${{ matrix.python-version }} --cover-quiet --randomize --parallel --retries 5 --retry-delay 3
+      - name: Run tests
+        run: hatch test --python ${{ matrix.python-version }} --cover-quiet --randomize --parallel --retries 5 --retry-delay 3
 
-    - name: Disambiguate coverage filename
-      run: mv .coverage ".coverage.${{ matrix.os }}.${{ matrix.python-version }}"
+      - name: Disambiguate coverage filename
+        run: mv .coverage ".coverage.${{ matrix.os }}.${{ matrix.python-version }}"
 
-    - name: Upload coverage data
-      uses: actions/upload-artifact@v4
-      with:
-        include-hidden-files: true
-        name: coverage-${{ matrix.os }}-${{ matrix.python-version }}
-        path: .coverage*
+      - name: Upload coverage data
+        uses: actions/upload-artifact@v4
+        with:
+          include-hidden-files: true
+          name: coverage-${{ matrix.os }}-${{ matrix.python-version }}
+          path: .coverage*
 
   coverage:
     name: Report coverage
     runs-on: ubuntu-latest
     needs:
-    - run
+      - run
 
     steps:
-    - uses: actions/checkout@v4
+      - uses: actions/checkout@v4
 
-    - name: Install Hatch
-      uses: pypa/hatch@install
+      - name: Install Hatch
+        uses: pypa/hatch@install
 
-    - name: Trigger build for auto-generated files
-      run: hatch build --hooks-only
+      - name: Trigger build for auto-generated files
+        run: hatch build --hooks-only
 
-    - name: Download coverage data
-      uses: actions/download-artifact@v4
-      with:
-        pattern: coverage-*
-        merge-multiple: true
+      - name: Download coverage data
+        uses: actions/download-artifact@v4
+        with:
+          pattern: coverage-*
+          merge-multiple: true
 
-    - name: Combine coverage data
-      run: hatch run coverage:combine
+      - name: Combine coverage data
+        run: hatch run coverage:combine
 
-    - name: Export coverage reports
-      run: |
-        hatch run coverage:report-xml
-        hatch run coverage:report-uncovered-html
+      - name: Export coverage reports
+        run: |
+          hatch run coverage:report-xml
+          hatch run coverage:report-uncovered-html
 
-    - name: Upload uncovered HTML report
-      uses: actions/upload-artifact@v4
-      with:
-        name: uncovered-html-report
-        path: htmlcov
+      - name: Upload uncovered HTML report
+        uses: actions/upload-artifact@v4
+        with:
+          name: uncovered-html-report
+          path: htmlcov
 
-    - name: Generate coverage summary
-      run: hatch run coverage:generate-summary
+      - name: Generate coverage summary
+        run: hatch run coverage:generate-summary
 
-    - name: Write coverage summary report
-      if: github.event_name == 'pull_request'
-      run: hatch run coverage:write-summary-report
+      - name: Write coverage summary report
+        if: github.event_name == 'pull_request'
+        run: hatch run coverage:write-summary-report
 
-    - name: Update coverage pull request comment
-      if: github.event_name == 'pull_request' && !github.event.pull_request.head.repo.fork
-      uses: marocchino/sticky-pull-request-comment@v2
-      with:
-        path: coverage-report.md
+      - name: Update coverage pull request comment
+        if: github.event_name == 'pull_request' && !github.event.pull_request.head.repo.fork
+        uses: marocchino/sticky-pull-request-comment@v2
+        with:
+          path: coverage-report.md
 
   downstream:
     name: Downstream builds with Python ${{ matrix.python-version }}
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
 
     steps:
-    - uses: actions/checkout@v4
+      - uses: actions/checkout@v4
 
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
-      with:
-        python-version: ${{ matrix.python-version }}
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
 
-    - name: Install tools
-      run: pip install --upgrade -r backend/tests/downstream/requirements.txt
+      - name: Install tools
+        run: pip install --upgrade -r backend/tests/downstream/requirements.txt
 
-    - name: Build downstream projects
-      run: python backend/tests/downstream/integrate.py
+      - name: Build downstream projects
+        run: python backend/tests/downstream/integrate.py
 
   # https://github.com/marketplace/actions/alls-green#why
   check: # This job does nothing and is only used for the branch protection
     if: always()
 
     needs:
-    - coverage
-    - downstream
+      - coverage
+      - downstream
 
     runs-on: ubuntu-latest
 
     steps:
-    - name: Decide whether the needed jobs succeeded or failed
-      uses: re-actors/alls-green@release/v1
-      with:
-        jobs: ${{ toJSON(needs) }}
+      - name: Decide whether the needed jobs succeeded or failed
+        uses: re-actors/alls-green@release/v1
+        with:
+          jobs: ${{ toJSON(needs) }}

docs/history/hatchling.md

@@ -12,6 +12,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 - Drop support for Python 3.8
 
+***Changed:***
+
+- Drop support for Python 3.8
+
 ## [1.27.0](https://github.com/pypa/hatch/releases/tag/hatchling-v1.27.0) - 2024-11-26 ## {: #hatchling-v1.27.0 }
 
 ***Added:***

docs/meta/authors.md

@@ -17,3 +17,4 @@
 - Olga Matoula [:material-github:](https://github.com/olgarithms) [:material-twitter:](https://twitter.com/olgarithms_)
 - Philip Blair [:material-email:](mailto:[email protected])
 - Robert Rosca [:material-github:](https://github.com/robertrosca)
+- Cary Hawkins [:material-github](https://github.com/cjames23)

docs/plugins/environment/reference.md

@@ -51,6 +51,7 @@ All environment types should [offer support](#hatch.env.plugin.interface.Environ
       - dependencies_in_sync
       - sync_dependencies
       - dependency_hash
+      - project_dependencies
       - project_root
       - sep
       - pathsep

hatch.toml

@@ -1,25 +1,24 @@
+
 [envs.hatch-static-analysis]
 config-path = "ruff_defaults.toml"
 
 [envs.default]
 installer = "uv"
-post-install-commands = [
-  "uv pip install {verbosity:flag:-1} -e ./backend",
+
+[envs.workspace-test]
+dependencies = [
+  "pytest",
 ]
 
 [envs.hatch-test]
 extra-dependencies = [
   "filelock",
   "flit-core",
-  "hatchling",
   "pyfakefs",
   "trustme",
   # Hatchling dynamic dependency
   "editables",
 ]
-post-install-commands = [
-  "pip install {verbosity:flag:-1} -e ./backend",
-]
 extra-args = ["--dist", "worksteal"]
 
 [envs.hatch-test.extra-scripts]
@@ -53,18 +52,19 @@ dependencies = [
   "mkdocs-minify-plugin~=0.8.0",
   "mkdocs-git-revision-date-localized-plugin~=1.2.5",
   "mkdocs-git-committers-plugin-2~=2.3.0",
-  "mkdocstrings-python~=1.10.3",
+  "mkdocstrings[python]~=0.26.0",
   "mkdocs-redirects~=1.2.1",
   "mkdocs-glightbox~=0.4.0",
   "mike~=2.1.1",
+  "mkdocs-autorefs>=1.0.0",
   # Extensions
   "mkdocs-click~=0.8.1",
   "pymdown-extensions~=10.8.1",
   # Necessary for syntax highlighting in code blocks
   "pygments~=2.18.0",
   # Validation
   "linkchecker~=10.5.0",
-  "griffe<1.0",
+  "griffe>=1.0.0",
 ]
 pre-install-commands = [
   "python scripts/install_mkdocs_material_insiders.py",
@@ -86,7 +86,7 @@ ci-build = "mike deploy --config-file {env:MKDOCS_CONFIG} --update-aliases {args
 validate = "linkchecker --config .linkcheckerrc site"
 # https://github.com/linkchecker/linkchecker/issues/678
 build-check = [
-  "build --no-directory-urls",
+  "python -W ignore::DeprecationWarning -m mkdocs build --no-directory-urls",
   "validate",
 ]
 
@@ -125,9 +125,7 @@ update-ruff = [
 [envs.release]
 detached = true
 installer = "uv"
-dependencies = [
-  "hatchling",
-]
+
 [envs.release.scripts]
 bump = "python scripts/bump.py {args}"
 github = "python scripts/release_github.py {args}"

pyproject.toml

@@ -39,7 +39,7 @@ classifiers = [
 ]
 dependencies = [
   "click>=8.0.6",
-  "hatchling>=1.24.2",
+  "hatchling>=1.27.0",
   "httpx>=0.22.0",
   "hyperlink>=21.0.0",
   "keyring>=23.5.0",
@@ -68,6 +68,9 @@ Source = "https://github.com/pypa/hatch"
 [project.scripts]
 hatch = "hatch.cli:main"
 
+[tool.hatch.workspace]
+members = ["backend/"]
+
 [tool.hatch.version]
 source = "vcs"