pyvista-build 0.1.0__tar.gz

pyvista_build-0.1.0/.github/dependabot.yml

@@ -0,0 +1,15 @@
+version: 2
+multi-ecosystem-groups:
+  maintenance:
+    schedule:
+      interval: quarterly
+    labels: [maintenance, dependencies]
+updates:
+- package-ecosystem: pip
+  directory: /
+  patterns: ['*']
+  multi-ecosystem-group: maintenance
+- package-ecosystem: github-actions
+  directory: /
+  patterns: ['*']
+  multi-ecosystem-group: maintenance

pyvista_build-0.1.0/.github/exclude_typing_lines.py

@@ -0,0 +1,72 @@
+"""Drop the lines coverage excludes from mypy's Cobertura typing report."""
+
+from __future__ import annotations
+
+from pathlib import Path
+import re
+import sys
+import tomllib
+import xml.etree.ElementTree as ET
+
+
+def _code(line: str) -> str:
+    """Return ``line`` without its trailing comment and whitespace."""
+    return line.split('#', 1)[0].rstrip()
+
+
+def excluded_lines(source: str, patterns: list[re.Pattern[str]]) -> set[int]:
+    """Return the lines the patterns match, extended to whole statements and their blocks."""
+    lines = source.split('\n')
+    excluded: set[int] = set()
+    for pattern in patterns:
+        for match in pattern.finditer(source):
+            first = source.count('\n', 0, match.start()) + 1
+            if not lines[first - 1].strip():
+                first += 1
+            last = source.count('\n', 0, match.end()) + 1
+            depth = sum(
+                _code(line).count('(') - _code(line).count(')') for line in lines[first - 1 : last]
+            )
+            while depth > 0 and last < len(lines):
+                last += 1
+                depth += _code(lines[last - 1]).count('(') - _code(lines[last - 1]).count(')')
+            excluded.update(range(first, last + 1))
+            opener = lines[first - 1]
+            if _code(lines[last - 1]).endswith(':'):
+                indent = len(opener) - len(opener.lstrip())
+                for number in range(last + 1, len(lines) + 1):
+                    line = lines[number - 1]
+                    if line.strip() and len(line) - len(line.lstrip()) <= indent:
+                        break
+                    excluded.add(number)
+    return excluded
+
+
+def main(report: Path) -> None:
+    """Rewrite ``report`` without the lines ``[tool.coverage.report]`` excludes."""
+    config = tomllib.loads(Path('pyproject.toml').read_text())
+    patterns = [
+        re.compile(p, re.MULTILINE) for p in config['tool']['coverage']['report']['exclude_also']
+    ]
+    tree = ET.parse(report)
+    for cls in tree.iter('class'):
+        lines = cls.find('lines')
+        filename = cls.get('filename')
+        # A data directory inside the package shows up as a namespace package.
+        if lines is None or not filename or not Path(filename).is_file():
+            continue
+        excluded = excluded_lines(Path(filename).read_text(), patterns)
+        for line in list(lines):
+            if int(line.get('number', '0')) in excluded:
+                lines.remove(line)
+    total = sum(1 for _ in tree.iter('line'))
+    hit = sum(1 for line in tree.iter('line') if int(line.get('hits', '0')) > 0)
+    root = tree.getroot()
+    root.set('lines-valid', str(total))
+    root.set('lines-covered', str(hit))
+    root.set('line-rate', f'{hit / total:.4f}' if total else '1')
+    tree.write(report)
+
+
+if __name__ == '__main__':
+    main(Path(sys.argv[1]))

pyvista_build-0.1.0/.github/release.yml

@@ -0,0 +1,9 @@
+changelog:
+  exclude:
+    authors:
+    - dependabot
+    - dependabot[bot]
+    - pre-commit-ci
+    - pre-commit-ci[bot]
+    - github-actions
+    - github-actions[bot]

pyvista_build-0.1.0/.github/workflows/build-vtk.yml

@@ -0,0 +1,131 @@
+name: Build VTK
+
+# Builds the shipped manifest's VTK release on all three operating systems with the
+# command this package ships, then installs the wheel and imports it.
+on:
+  workflow_dispatch:
+  pull_request:
+      # labeled and unlabeled, so adding skip-build takes effect without a push.
+    types: [opened, synchronize, reopened, labeled, unlabeled]
+      # A pull request that only touches these never starts a build.
+    paths-ignore:
+    - '**.md'
+    - '**.rst'
+    - doc/**
+    - codecov.yml
+    - .pre-commit-config.yaml
+    - .github/dependabot.yml
+    - .github/release.yml
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  actions: read
+  contents: read
+
+jobs:
+  build:
+      # The skip-build label turns the build off for a pull request by hand.
+    if: ${{ !contains(github.event.pull_request.labels.*.name, 'skip-build') }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    env:
+      CCACHE_MAXSIZE: 1G
+      SCCACHE_CACHE_SIZE: 1G
+    steps:
+    - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1   # v7.0.1
+      with:
+        persist-credentials: false
+        fetch-depth: 0
+
+    - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065   # v5.6.0
+      with:
+        python-version: '3.14'
+
+    - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7   # v10.2.0
+
+    - name: Install macOS build dependencies
+      if: runner.os == 'macOS'
+      run: brew install ccache
+
+    - name: Install pyvista-build
+      shell: bash
+        # `--manylinux` mounts this installed package into the container.
+      run: uv pip install --system '.[tools]'
+
+      # An artifact, not actions/cache: the repository's shared cache quota evicts a
+      # large entry before the next run can restore it.
+    - name: Find the newest compiler cache from this branch or main
+      id: find-compiler-cache
+      shell: bash
+      env:
+        GH_TOKEN: ${{ github.token }}
+        BRANCH: ${{ github.head_ref || github.ref_name }}
+      run: |
+        # Newest first: this branch's own upload, else main's, from this repository only.
+        if ! run_id="$(gh api "repos/${GITHUB_REPOSITORY}/actions/artifacts?name=compiler-cache-${RUNNER_OS}&per_page=50" \
+          --jq '[.artifacts[] | select((.expired | not) and .workflow_run.head_repository_id == .workflow_run.repository_id)] as $a
+            | ([$a[] | select(.workflow_run.head_branch == env.BRANCH)] + [$a[] | select(.workflow_run.head_branch == "main")])[0].workflow_run.id // empty')"; then
+          echo "::warning::Could not list the compiler cache artifacts; building cold"
+          run_id=""
+        fi
+        if [ -n "$run_id" ]; then
+          echo "Restoring the compiler cache uploaded by run $run_id"
+        else
+          echo "No compiler cache artifact found; building cold"
+        fi
+        echo "run-id=$run_id" >> "$GITHUB_OUTPUT"
+
+    - name: Restore compiler cache
+      if: steps.find-compiler-cache.outputs.run-id != ''
+      uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c   # v8.0.1
+      continue-on-error: true
+      with:
+        name: compiler-cache-${{ runner.os }}
+        run-id: ${{ steps.find-compiler-cache.outputs.run-id }}
+        github-token: ${{ github.token }}
+        path: compiler-cache
+
+    - uses: ilammy/msvc-dev-cmd@0b201ec74fa43914dc39ae48a89fd1d8cb592756   # v1.13.0
+      if: runner.os == 'Windows'
+
+    - name: Set up sccache (Windows)
+      if: runner.os == 'Windows'
+      uses: mozilla-actions/sccache-action@fc920bf0ec8de6ee65d409111f7ec508035751ba   # v0.0.9
+
+    - name: Build the VTK wheel
+      shell: bash
+        # --manylinux (Linux) builds inside the manylinux_2_28 container.
+      env:
+        MANYLINUX: ${{ runner.os == 'Linux' && '--manylinux' || '' }}
+        FORCE_COLOR: '1'
+      run: |
+        pyvista-build vtk $MANYLINUX --yes --verbose \
+          --build-dir vtk-build --compiler-cache auto --cache-dir compiler-cache
+
+      # Fork pull requests read the cache but never upload one.
+    - name: Upload compiler cache
+      if: ${{ !cancelled() && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository) }}
+      uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a   # v7.0.1
+      with:
+        name: compiler-cache-${{ runner.os }}
+        path: compiler-cache
+        compression-level: 0
+        retention-days: 7
+
+    - name: Upload the wheel
+      uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a   # v7.0.1
+      with:
+        name: vtk-wheel-${{ runner.os }}
+        path: vtk-build/wheelhouse/*.whl
+
+    - name: Install the wheel and import it
+      shell: bash
+      run: |
+        uv pip install --system vtk-build/wheelhouse/*.whl
+        python -c "import vtk; print(vtk.vtkVersion.GetVTKVersion())"

pyvista_build-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,182 @@
+name: CI
+
+# `pull_request` is deliberately unfiltered: filtering it by base branch would
+# skip every pull request in a stack that does not target main.
+on:
+  push:
+    branches: [main]
+    tags: [v*]
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  pre-commit:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1   # v7.0.1
+      with:
+        persist-credentials: false
+        fetch-depth: 0
+    - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7   # v10.2.0
+      with:
+        enable-cache: false
+    - run: uv sync --group dev
+    - run: uv run pre-commit run --all-files --show-diff-on-failure
+      env:
+          # This hook exists to stop *local* commits straight to main; it
+          # would always fail here since CI checks out that branch/tag directly.
+        SKIP: no-commit-to-branch
+
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        python-version: ['3.11', '3.12', '3.13', '3.14']
+        include:
+        - os: macos-latest
+          python-version: '3.14'
+        - os: windows-latest
+          python-version: '3.14'
+    steps:
+    - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1   # v7.0.1
+      with:
+        persist-credentials: false
+        fetch-depth: 0
+    - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7   # v10.2.0
+      with:
+        enable-cache: false
+    - run: uv sync --group dev --python ${{ matrix.python-version }}
+    - run: uv run pytest
+    - run: mv .coverage .coverage.test-${{ matrix.os }}-${{ matrix.python-version }}
+      shell: bash
+    - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a   # v7.0.1
+      with:
+        name: coverage-test-${{ matrix.os }}-${{ matrix.python-version }}
+        path: .coverage.test-${{ matrix.os }}-${{ matrix.python-version }}
+        include-hidden-files: true
+
+  coverage:
+      # Combine the matrix's coverage and gate the total and the patch.
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1   # v7.0.1
+      with:
+        persist-credentials: false
+        fetch-depth: 0
+    - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7   # v10.2.0
+      with:
+        enable-cache: false
+    - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c   # v8.0.1
+      with:
+        pattern: coverage-*
+        path: coverage-data
+        merge-multiple: true
+    - run: uv run --only-group coverage coverage combine coverage-data
+    - run: uv run --only-group coverage coverage xml
+    - run: uv run --only-group coverage coverage report --fail-under=95
+    - name: Patch coverage
+      if: ${{ !cancelled() && github.event_name == 'pull_request' }}
+      run: uv run --only-group coverage diff-cover coverage.xml --compare-branch "origin/$GITHUB_BASE_REF" --fail-under 95 --format markdown:diff-cover.md
+    - if: ${{ !cancelled() && github.event_name == 'pull_request' }}
+      run: cat diff-cover.md >> "$GITHUB_STEP_SUMMARY" || true
+    - uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5   # v7.1.1
+      if: ${{ !cancelled() }}
+      with:
+        files: ./coverage.xml
+        flags: tests
+      env:
+        CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+  typing:
+      # mypy's Cobertura report counts a line as covered when every expression on
+      # it has a precise type, so codecov shows typing coverage next to test coverage.
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1   # v7.0.1
+      with:
+        persist-credentials: false
+        fetch-depth: 0
+    - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7   # v10.2.0
+      with:
+        enable-cache: false
+    - run: uv sync --group dev --python 3.14
+    - run: uv run --no-sync mypy --cobertura-xml-report typing-coverage --txt-report typing-coverage
+    - run: cat typing-coverage/index.txt
+    - run: uv run --no-sync python .github/exclude_typing_lines.py typing-coverage/cobertura.xml
+    - uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5   # v7.1.1
+      with:
+        files: ./typing-coverage/cobertura.xml
+        flags: typing
+      env:
+        CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1   # v7.0.1
+      with:
+        persist-credentials: false
+        fetch-depth: 0
+    - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7   # v10.2.0
+      with:
+        enable-cache: false
+    - run: uv sync --group docs --python 3.14
+    - run: uv run --no-sync sphinx-build -W --keep-going -b html doc doc/_build/html
+    - uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9   # v5.0.0
+      with:
+        path: doc/_build/html/
+
+  deploy-docs:
+      # Publishes directly from the workflow artifact; no gh-pages branch.
+    needs: docs
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    permissions:
+      pages: write
+      id-token: write
+    steps:
+    - uses: actions/deploy-pages@368f82528645a54fb793d4d04e342629a3f51346   # v5.0.1
+      id: deployment
+
+  dist:
+    needs: [pre-commit, test, coverage, typing, docs]
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1   # v7.0.1
+      with:
+        persist-credentials: false
+        fetch-depth: 0
+    - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7   # v10.2.0
+      with:
+        enable-cache: false
+    - run: uv build
+    - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a   # v7.0.1
+      with:
+        name: dist
+        path: dist/
+
+  publish:
+    needs: dist
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write
+    steps:
+    - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c   # v8.0.1
+      with:
+        name: dist
+        path: dist/
+    - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33   # release/v1

pyvista_build-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+*-build/
+*.egg-info/
+.DS_Store
+.coverage
+.coverage.*
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.venv/
+__pycache__/
+build/
+dist/
+doc/_build/
+pyvista_build/_version.py
+typing-coverage/
+uv.lock

pyvista_build-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,45 @@
+ci:
+  autoupdate_commit_msg: 'chore: update pre-commit hooks'
+  autofix_prs: true
+  autoupdate_schedule: quarterly
+
+repos:
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v5.0.0
+  hooks:
+  - id: check-merge-conflict
+  - id: debug-statements
+  - id: no-commit-to-branch
+    args: [--branch, main]
+
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: v0.16.0
+  hooks:
+  - id: ruff-check
+    args: [--fix, --show-fixes]
+  - id: ruff-format
+
+- repo: https://github.com/zizmorcore/zizmor-pre-commit
+  rev: v1.11.0
+  hooks:
+  - id: zizmor
+
+- repo: https://github.com/macisamuele/language-formatters-pre-commit-hooks
+  rev: v2.15.0
+  hooks:
+  - id: pretty-format-yaml
+    args: [--autofix, --indent, '2']
+
+- repo: https://github.com/sphinx-contrib/sphinx-lint
+  rev: v1.0.2
+  hooks:
+  - id: sphinx-lint
+      # Same line length as the Python sources.
+    args: [--enable, line-too-long, --max-line-length, '99']
+
+- repo: https://github.com/ComPWA/taplo-pre-commit
+  rev: v0.9.3
+  hooks:
+  - id: taplo-format
+      # See options: https://taplo.tamasfe.dev/configuration/formatter-options.html
+    args: [--option, reorder_arrays=true, --option, reorder_keys=true, --option, align_comments=false]

pyvista_build-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2017-2026 The PyVista Developers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

pyvista_build-0.1.0/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: pyvista-build
+Version: 0.1.0
+Summary: Build a VTK backend wheel for PyVista from source, guided step by step.
+Author-email: The PyVista Developers <info@pyvista.org>
+License-Expression: MIT
+Project-URL: Repository, https://github.com/pyvista/pyvista-build
+Keywords: cmake,pyvista,vtk,wheel
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cyclopts>=4.0.0
+Requires-Dist: packaging
+Requires-Dist: rich
+Provides-Extra: tools
+Requires-Dist: auditwheel; sys_platform == "linux" and extra == "tools"
+Requires-Dist: cmake>=3.22; extra == "tools"
+Requires-Dist: delocate; sys_platform == "darwin" and extra == "tools"
+Requires-Dist: delvewheel; sys_platform == "win32" and extra == "tools"
+Requires-Dist: ninja>=1.11; extra == "tools"
+Requires-Dist: patchelf; sys_platform == "linux" and extra == "tools"
+Requires-Dist: setuptools; extra == "tools"
+Requires-Dist: wheel; extra == "tools"
+Dynamic: license-file
+
+# pyvista-build
+
+Build a VTK backend wheel for [PyVista](https://github.com/pyvista/pyvista) from source,
+guided step by step.
+
+```bash
+uv venv
+uvx pyvista-build vtk --install
+uv pip install pyvista
+```
+
+`pyvista-build BACKEND` clones the backend, checks the tools it needs and offers to
+install the missing ones, configures it with CMake, compiles it, packages the wheel,
+bundles the libraries it links against, and installs it into the active virtual
+environment, else `.venv` in the current directory, else the Python running the command
+(`--python PATH` picks another one). It asks once before starting and prints every
+command as it runs.
+`--interactive` asks before each step, `--dry-run` prints the commands and runs nothing,
+and `--manylinux` runs the build inside a manylinux container for a portable Linux wheel.
+
+Each backend describes its build in a `pyvista-build.toml` manifest at the root of its
+source tree. A manifest for stock VTK is shipped here, and `pyvista-build cvista` reads
+the one in the [cvista](https://github.com/pyvista/cvista) tree. Any other backend builds
+with `--url <git url>` or `--source <checkout>` when its tree carries a manifest. The
+[manifest reference](https://pyvista.github.io/pyvista-build/manifest.html) lists every
+key.
+
+The package depends on neither `vtk` nor `pyvista`, so it runs in an environment that
+has no VTK yet.
+
+## Development
+
+```bash
+uv sync --group dev
+uv run pytest
+uv run mypy
+uv run pre-commit run --all-files
+uv run --group docs sphinx-build -W doc doc/_build/html
+```

pyvista_build-0.1.0/README.md

@@ -0,0 +1,39 @@
+# pyvista-build
+
+Build a VTK backend wheel for [PyVista](https://github.com/pyvista/pyvista) from source,
+guided step by step.
+
+```bash
+uv venv
+uvx pyvista-build vtk --install
+uv pip install pyvista
+```
+
+`pyvista-build BACKEND` clones the backend, checks the tools it needs and offers to
+install the missing ones, configures it with CMake, compiles it, packages the wheel,
+bundles the libraries it links against, and installs it into the active virtual
+environment, else `.venv` in the current directory, else the Python running the command
+(`--python PATH` picks another one). It asks once before starting and prints every
+command as it runs.
+`--interactive` asks before each step, `--dry-run` prints the commands and runs nothing,
+and `--manylinux` runs the build inside a manylinux container for a portable Linux wheel.
+
+Each backend describes its build in a `pyvista-build.toml` manifest at the root of its
+source tree. A manifest for stock VTK is shipped here, and `pyvista-build cvista` reads
+the one in the [cvista](https://github.com/pyvista/cvista) tree. Any other backend builds
+with `--url <git url>` or `--source <checkout>` when its tree carries a manifest. The
+[manifest reference](https://pyvista.github.io/pyvista-build/manifest.html) lists every
+key.
+
+The package depends on neither `vtk` nor `pyvista`, so it runs in an environment that
+has no VTK yet.
+
+## Development
+
+```bash
+uv sync --group dev
+uv run pytest
+uv run mypy
+uv run pre-commit run --all-files
+uv run --group docs sphinx-build -W doc doc/_build/html
+```

pyvista_build-0.1.0/codecov.yml

@@ -0,0 +1,26 @@
+# Test coverage and typing coverage are uploaded under separate flags so
+# neither number hides the other.
+flags:
+  tests:
+    paths: [pyvista_build/]
+    carryforward: true
+  typing:
+    paths: [pyvista_build/]
+    carryforward: true
+
+coverage:
+  status:
+    project:
+      tests:
+        flags: [tests]
+        target: 95%
+      typing:
+        flags: [typing]
+        target: 97.5%
+    patch:
+      tests:
+        flags: [tests]
+        target: 95%
+      typing:
+        flags: [typing]
+        target: 98.5%

pyvista_build-0.1.0/doc/Makefile

@@ -0,0 +1,14 @@
+# Minimal makefile for Sphinx documentation
+
+SPHINXOPTS    ?= -W --keep-going
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)