foam-wiki 0.4.0.dev0__tar.gz

foam_wiki-0.4.0.dev0/.github/workflows/ci.yml

@@ -0,0 +1,262 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  python-quality:
+    name: Python lint and type check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version-file: .python-version
+      - uses: actions-rust-lang/setup-rust-toolchain@166cdcfd11aee3cb47222f9ddb555ce30ddb9659 # v1
+        with:
+          toolchain: stable
+      - uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+        with:
+          enable-cache: true
+      - name: Install
+        run: uv sync --locked
+      - name: Ruff
+        run: uv run ruff check .
+      - name: Basedpyright
+        run: uv run basedpyright src scripts
+
+  python-tests:
+    name: Python ${{ matrix.python-version }} tests
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - "3.10"
+          - "3.12"
+          - "3.14"
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - uses: actions-rust-lang/setup-rust-toolchain@166cdcfd11aee3cb47222f9ddb555ce30ddb9659 # v1
+        with:
+          toolchain: stable
+      - uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+        with:
+          enable-cache: true
+      - name: Install
+        run: uv sync --locked --python python
+      - name: Pytest
+        run: uv run --no-sync pytest -q
+
+  rust:
+    name: Rust format, lint, and tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version-file: .python-version
+      - uses: actions-rust-lang/setup-rust-toolchain@166cdcfd11aee3cb47222f9ddb555ce30ddb9659 # v1
+        with:
+          toolchain: stable
+          components: rustfmt, clippy
+      - name: Rustfmt
+        run: cargo fmt --all --check
+      - name: Clippy
+        run: cargo clippy --all-targets --all-features --locked -- -D warnings
+      - name: Cargo tests
+        run: cargo test --all-targets --all-features --locked
+
+  rust-msrv:
+    name: Rust MSRV (1.88)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version-file: .python-version
+      - uses: actions-rust-lang/setup-rust-toolchain@166cdcfd11aee3cb47222f9ddb555ce30ddb9659 # v1
+        with:
+          toolchain: "1.88.0"
+      - name: Check minimum supported Rust version
+        run: cargo check --all-targets --all-features --locked
+
+  wheels-linux:
+    name: Linux wheel (${{ matrix.target }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        target:
+          - x86_64-unknown-linux-gnu
+          - aarch64-unknown-linux-gnu
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.10"
+      - name: Build manylinux2014 wheel
+        uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          command: build
+          maturin-version: v1.14.1
+          target: ${{ matrix.target }}
+          manylinux: "2014"
+          rust-toolchain: stable
+          args: --release --locked --out dist
+      - name: Smoke-test installed wheel
+        if: matrix.target == 'x86_64-unknown-linux-gnu'
+        shell: bash
+        run: |
+          python -m venv "$RUNNER_TEMP/foamwiki-wheel-smoke"
+          smoke_python="$RUNNER_TEMP/foamwiki-wheel-smoke/bin/python"
+          smoke_cli="$RUNNER_TEMP/foamwiki-wheel-smoke/bin/foamwiki"
+          "$smoke_python" -m pip install dist/*.whl
+          "$smoke_python" -m pip install "pytest>=8,<10" "pandas>=2" "networkx>=3"
+          "$smoke_python" -m pytest -q
+          (
+            cd "$RUNNER_TEMP"
+            "$smoke_python" -I -c "import foamwiki, foamwiki._core; print(foamwiki.__version__)"
+            "$smoke_cli" --help >/dev/null
+          )
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: wheels-linux-${{ matrix.target }}
+          path: dist/*.whl
+
+  wheels-macos:
+    name: macOS wheel (${{ matrix.target }})
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: macos-15-intel
+            target: x86_64-apple-darwin
+          - runner: macos-15
+            target: aarch64-apple-darwin
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.10"
+      - name: Build macOS wheel
+        uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          command: build
+          maturin-version: v1.14.1
+          target: ${{ matrix.target }}
+          rust-toolchain: stable
+          args: --release --locked --out dist
+      - name: Smoke-test installed wheel
+        shell: bash
+        run: |
+          python -m venv "$RUNNER_TEMP/foamwiki-wheel-smoke"
+          smoke_python="$RUNNER_TEMP/foamwiki-wheel-smoke/bin/python"
+          smoke_cli="$RUNNER_TEMP/foamwiki-wheel-smoke/bin/foamwiki"
+          "$smoke_python" -m pip install dist/*.whl
+          "$smoke_python" -m pip install "pytest>=8,<10" "pandas>=2" "networkx>=3"
+          "$smoke_python" -m pytest -q
+          (
+            cd "$RUNNER_TEMP"
+            "$smoke_python" -I -c "import foamwiki, foamwiki._core; print(foamwiki.__version__)"
+            "$smoke_cli" --help >/dev/null
+          )
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: wheels-macos-${{ matrix.target }}
+          path: dist/*.whl
+
+  wheels-windows:
+    name: Windows wheel (x86_64)
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.10"
+      - name: Build Windows wheel
+        uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          command: build
+          maturin-version: v1.14.1
+          target: x86_64-pc-windows-msvc
+          rust-toolchain: stable
+          args: --release --locked --out dist
+      - name: Smoke-test installed wheel
+        shell: pwsh
+        run: |
+          $venv = Join-Path $env:RUNNER_TEMP "foamwiki-wheel-smoke"
+          python -m venv $venv
+          if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+          $smokePython = Join-Path $venv "Scripts/python.exe"
+          $smokeCli = Join-Path $venv "Scripts/foamwiki.exe"
+          $wheel = (Resolve-Path "dist/*.whl").Path
+          & $smokePython -m pip install $wheel
+          if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+          & $smokePython -m pip install "pytest>=8,<10" "pandas>=2" "networkx>=3"
+          if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+          & $smokePython -m pytest -q
+          if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+          Push-Location $env:RUNNER_TEMP
+          try {
+            & $smokePython -I -c "import foamwiki, foamwiki._core; print(foamwiki.__version__)"
+            if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+            & $smokeCli --help > $null
+            if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+          } finally {
+            Pop-Location
+          }
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: wheels-windows-x86_64
+          path: dist/*.whl
+
+  sdist:
+    name: Source distribution smoke test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.10"
+      - name: Build source distribution
+        uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          command: sdist
+          maturin-version: v1.14.1
+          rust-toolchain: stable
+          args: --out dist
+      - name: Install and import source distribution
+        shell: bash
+        run: |
+          if tar -tzf dist/*.tar.gz | grep -q '/dist/'; then
+            echo "source distribution unexpectedly contains build artifacts" >&2
+            exit 1
+          fi
+          python -m venv "$RUNNER_TEMP/foamwiki-sdist-smoke"
+          smoke_python="$RUNNER_TEMP/foamwiki-sdist-smoke/bin/python"
+          "$smoke_python" -m pip install dist/*.tar.gz
+          (
+            cd "$RUNNER_TEMP"
+            "$smoke_python" -c "import foamwiki, foamwiki._core; print(foamwiki.__version__)"
+          )
+          "$RUNNER_TEMP/foamwiki-sdist-smoke/bin/foamwiki" --help >/dev/null
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: sdist
+          path: dist/*.tar.gz

foam_wiki-0.4.0.dev0/.github/workflows/release.yml

@@ -0,0 +1,357 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  validate:
+    name: Validate release metadata
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version-file: .python-version
+      - uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+      - id: version
+        name: Check names, versions, locks, and tag
+        shell: bash
+        run: |
+          args=()
+          if [[ "$GITHUB_REF_TYPE" == "tag" ]]; then
+            args+=(--tag "$GITHUB_REF_NAME")
+            git fetch --no-tags origin main
+            if ! git merge-base --is-ancestor "$GITHUB_SHA" origin/main; then
+              echo "release tag must point to a commit reachable from main" >&2
+              exit 1
+            fi
+          fi
+          version="$(
+            uv run --no-project --with packaging==26.2 \
+              python scripts/check_release.py "${args[@]}" --print-version
+          )"
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+
+  wheels-linux:
+    name: Linux wheel (${{ matrix.target }})
+    needs: validate
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        target:
+          - x86_64-unknown-linux-gnu
+          - aarch64-unknown-linux-gnu
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.10"
+      - name: Build manylinux2014 wheel
+        uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          command: build
+          maturin-version: v1.14.1
+          target: ${{ matrix.target }}
+          manylinux: "2014"
+          rust-toolchain: stable
+          args: --release --locked --out dist
+      - name: Smoke-test installed wheel
+        if: matrix.target == 'x86_64-unknown-linux-gnu'
+        shell: bash
+        run: |
+          python -m venv "$RUNNER_TEMP/foamwiki-wheel-smoke"
+          smoke_python="$RUNNER_TEMP/foamwiki-wheel-smoke/bin/python"
+          smoke_cli="$RUNNER_TEMP/foamwiki-wheel-smoke/bin/foamwiki"
+          "$smoke_python" -m pip install dist/*.whl
+          (
+            cd "$RUNNER_TEMP"
+            "$smoke_python" -I \
+              "$GITHUB_WORKSPACE/scripts/smoke_installed.py" \
+              "${{ needs.validate.outputs.version }}"
+            "$smoke_cli" --help >/dev/null
+            "$smoke_python" -I -m foamwiki --help >/dev/null
+          )
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: release-wheel-linux-${{ matrix.target }}
+          path: dist/*.whl
+          if-no-files-found: error
+
+  wheels-macos:
+    name: macOS wheel (${{ matrix.target }})
+    needs: validate
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: macos-15-intel
+            target: x86_64-apple-darwin
+          - runner: macos-15
+            target: aarch64-apple-darwin
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.10"
+      - name: Build macOS wheel
+        uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          command: build
+          maturin-version: v1.14.1
+          target: ${{ matrix.target }}
+          rust-toolchain: stable
+          args: --release --locked --out dist
+      - name: Smoke-test installed wheel
+        shell: bash
+        run: |
+          python -m venv "$RUNNER_TEMP/foamwiki-wheel-smoke"
+          smoke_python="$RUNNER_TEMP/foamwiki-wheel-smoke/bin/python"
+          smoke_cli="$RUNNER_TEMP/foamwiki-wheel-smoke/bin/foamwiki"
+          "$smoke_python" -m pip install dist/*.whl
+          (
+            cd "$RUNNER_TEMP"
+            "$smoke_python" -I \
+              "$GITHUB_WORKSPACE/scripts/smoke_installed.py" \
+              "${{ needs.validate.outputs.version }}"
+            "$smoke_cli" --help >/dev/null
+          )
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: release-wheel-macos-${{ matrix.target }}
+          path: dist/*.whl
+          if-no-files-found: error
+
+  wheels-windows:
+    name: Windows wheel (x86_64)
+    needs: validate
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.10"
+      - name: Build Windows wheel
+        uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          command: build
+          maturin-version: v1.14.1
+          target: x86_64-pc-windows-msvc
+          rust-toolchain: stable
+          args: --release --locked --out dist
+      - name: Smoke-test installed wheel
+        shell: pwsh
+        run: |
+          $venv = Join-Path $env:RUNNER_TEMP "foamwiki-wheel-smoke"
+          python -m venv $venv
+          if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+          $smokePython = Join-Path $venv "Scripts/python.exe"
+          $smokeCli = Join-Path $venv "Scripts/foamwiki.exe"
+          $wheel = (Resolve-Path "dist/*.whl").Path
+          & $smokePython -m pip install $wheel
+          if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+          Push-Location $env:RUNNER_TEMP
+          try {
+            & $smokePython -I `
+              "$env:GITHUB_WORKSPACE/scripts/smoke_installed.py" `
+              "${{ needs.validate.outputs.version }}"
+            if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+            & $smokeCli --help > $null
+            if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+          } finally {
+            Pop-Location
+          }
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: release-wheel-windows-x86_64
+          path: dist/*.whl
+          if-no-files-found: error
+
+  sdist:
+    name: Source distribution
+    needs: validate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.14"
+      - uses: actions-rust-lang/setup-rust-toolchain@166cdcfd11aee3cb47222f9ddb555ce30ddb9659 # v1
+        with:
+          toolchain: stable
+      - name: Build source distribution
+        uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          command: sdist
+          maturin-version: v1.14.1
+          rust-toolchain: stable
+          args: --out dist
+      - name: Smoke-test installed source distribution
+        shell: bash
+        run: |
+          python -m venv "$RUNNER_TEMP/foamwiki-sdist-smoke"
+          smoke_python="$RUNNER_TEMP/foamwiki-sdist-smoke/bin/python"
+          smoke_cli="$RUNNER_TEMP/foamwiki-sdist-smoke/bin/foamwiki"
+          "$smoke_python" -m pip install dist/*.tar.gz
+          (
+            cd "$RUNNER_TEMP"
+            "$smoke_python" -I \
+              "$GITHUB_WORKSPACE/scripts/smoke_installed.py" \
+              "${{ needs.validate.outputs.version }}"
+            "$smoke_cli" --help >/dev/null
+          )
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: release-sdist
+          path: dist/*.tar.gz
+          if-no-files-found: error
+
+  verify:
+    name: Verify complete distribution set
+    needs:
+      - validate
+      - wheels-linux
+      - wheels-macos
+      - wheels-windows
+      - sdist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: |
+            3.10
+            3.14
+      - uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          pattern: release-*
+          path: dist
+          merge-multiple: true
+      - name: Validate archive names, versions, contents, and platforms
+        run: |
+          uv run --no-project --with packaging==26.2 \
+            python scripts/verify_artifacts.py \
+              dist "${{ needs.validate.outputs.version }}" --release-matrix
+      - name: Check package metadata
+        run: |
+          uvx --from twine==6.2.0 twine check --strict dist/*
+          uvx --from check-wheel-contents==0.6.3 \
+            check-wheel-contents dist/*.whl
+          uv publish --dry-run --trusted-publishing never dist/*
+      - name: Repeat isolated x86 wheel and sdist smoke tests
+        shell: bash
+        run: |
+          wheel="$(find dist -maxdepth 1 -name '*manylinux*x86_64*.whl' -print -quit)"
+          sdist="$(find dist -maxdepth 1 -name '*.tar.gz' -print -quit)"
+          python3.10 -m venv "$RUNNER_TEMP/release-wheel"
+          "$RUNNER_TEMP/release-wheel/bin/python" -m pip install "$wheel"
+          (
+            cd "$RUNNER_TEMP"
+            "$RUNNER_TEMP/release-wheel/bin/python" -I \
+              "$GITHUB_WORKSPACE/scripts/smoke_installed.py" \
+              "${{ needs.validate.outputs.version }}"
+          )
+          python3.14 -m venv "$RUNNER_TEMP/release-sdist"
+          "$RUNNER_TEMP/release-sdist/bin/python" -m pip install "$sdist"
+          (
+            cd "$RUNNER_TEMP"
+            "$RUNNER_TEMP/release-sdist/bin/python" -I \
+              "$GITHUB_WORKSPACE/scripts/smoke_installed.py" \
+              "${{ needs.validate.outputs.version }}"
+          )
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: distributions
+          path: dist/*
+          if-no-files-found: error
+          retention-days: 14
+
+  publish:
+    name: Publish to PyPI
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    needs: verify
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/foam-wiki
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: distributions
+          path: dist
+      - name: Publish verified distributions
+        uses: pypa/gh-action-pypi-publish@ba38be9e461d3875417946c167d0b5f3d385a247 # release/v1
+        with:
+          packages-dir: dist
+          verbose: true
+
+  smoke-pypi:
+    name: Smoke-test PyPI
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    needs: publish
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.14"
+      - uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+      - name: Install the exact public-index wheel with propagation retries
+        shell: bash
+        run: |
+          version="${GITHUB_REF_NAME#v}"
+          uv venv "$RUNNER_TEMP/pypi-smoke"
+          smoke_python="$RUNNER_TEMP/pypi-smoke/bin/python"
+          installed=false
+          for attempt in {1..12}; do
+            if uv --no-cache pip install \
+              --python "$smoke_python" \
+              --only-binary :all: \
+              "foam-wiki==$version"; then
+              installed=true
+              break
+            fi
+            echo "PyPI propagation attempt $attempt failed; retrying"
+            sleep 10
+          done
+          [[ "$installed" == true ]]
+          (
+            cd "$RUNNER_TEMP"
+            "$smoke_python" -I - "$version" <<'PY'
+          import sys
+          import tempfile
+          from importlib import metadata
+          from pathlib import Path
+
+          import foamwiki
+          import foamwiki._core
+
+          version = sys.argv[1]
+          assert metadata.version("foam-wiki") == version
+          assert foamwiki.__version__ == version
+          with tempfile.TemporaryDirectory() as raw_root:
+              root = Path(raw_root)
+              (root / ".foam").mkdir()
+              (root / "index.md").write_text("# Index\n\nrelease smoke\n")
+              assert len(foamwiki.load(root).search("smoke")) == 1
+          PY
+            "$RUNNER_TEMP/pypi-smoke/bin/foamwiki" --help >/dev/null
+          )

foam_wiki-0.4.0.dev0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+_core*.so
+_core*.pyd
+.venv/
+dist/
+release-dist/
+build/
+target/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.basedpyright/
+.coverage

foam_wiki-0.4.0.dev0/.python-version

@@ -0,0 +1 @@
+3.12

foam_wiki-0.4.0.dev0/AGENTS.md

@@ -0,0 +1,24 @@
+# Agent guidance for foamwiki
+
+This repository is a standalone uv-managed Python package: a synchronous,
+notebook-first library + thin CLI for Foam-style markdown wikis.
+
+The public API is re-exported from `src/foamwiki/__init__.py`; implementation lives
+in underscore-prefixed modules. The CLI (`src/foamwiki/_cli.py`) is a thin argparse
+shim with no business logic.
+
+Use `uv run ...` for repository commands. The standard checks are:
+
+- `uv run ruff check .`
+- `uv run basedpyright src`
+- `uv run pytest -q`
+
+House style (the `python-coding` mantras): radical simplicity, dataclasses as
+data (not behavior), free functions for verbs, and one teachable placement rule:
+
+- intrinsic to a file's text -> attribute (`note.title`, `ws.notes`)
+- needs the whole vault -> method on the noun (`note.backlinks()`, `ws.resolve()`)
+- whole-graph algorithm or mutation -> free function `foamwiki.verb(ws, ...)`
+
+Fail loudly with the typed exceptions. pandas and networkx are soft, lazily
+imported dependencies; the core must never import them at module load.

foam_wiki-0.4.0.dev0/CLAUDE.md

@@ -0,0 +1,24 @@
+# Agent guidance for foamwiki
+
+This repository is a standalone uv-managed Python package: a synchronous,
+notebook-first library + thin CLI for Foam-style markdown wikis.
+
+The public API is re-exported from `src/foamwiki/__init__.py`; implementation lives
+in underscore-prefixed modules. The CLI (`src/foamwiki/_cli.py`) is a thin argparse
+shim with no business logic.
+
+Use `uv run ...` for repository commands. The standard checks are:
+
+- `uv run ruff check .`
+- `uv run basedpyright src`
+- `uv run pytest -q`
+
+House style (the `python-coding` mantras): radical simplicity, dataclasses as
+data (not behavior), free functions for verbs, and one teachable placement rule:
+
+- intrinsic to a file's text -> attribute (`note.title`, `ws.notes`)
+- needs the whole vault -> method on the noun (`note.backlinks()`, `ws.resolve()`)
+- whole-graph algorithm or mutation -> free function `foamwiki.verb(ws, ...)`
+
+Fail loudly with the typed exceptions. pandas and networkx are soft, lazily
+imported dependencies; the core must never import them at module load.