toolr 0.9.0__tar.gz

toolr-0.9.0/.codespell.words.ignore

@@ -0,0 +1 @@
+thirdparty

toolr-0.9.0/.coveragerc

@@ -0,0 +1,37 @@
+[run]
+branch = True
+cover_pylib = False
+parallel = True
+concurrency = multiprocessing
+
+source =
+  python/
+  tests/
+
+omit =
+  setup.py
+
+[report]
+# Regexes for lines to exclude from consideration
+exclude_lines =
+    # Have to re-enable the standard pragma
+    pragma: no cover
+
+    # Don't complain about missing debug-only code:
+    def __repr__
+
+    # Don't complain if tests don't hit defensive assertion code:
+    raise AssertionError
+    raise NotImplementedError
+
+    # Don't complain if non-runnable code isn't run:
+    if 0:
+    if False:
+    if __name__ == .__main__.:
+    if TYPE_CHECKING:
+
+omit =
+  setup.py
+
+
+ignore_errors = True

toolr-0.9.0/.github/actions/apply-release-patch/action.yml

@@ -0,0 +1,23 @@
+name: Apply Release Patch
+description: Prepare a release of ToolR
+
+inputs:
+  release-patch-name:
+    required: true
+    description: 'Release patch to apply'
+
+
+runs:
+  using: composite
+
+  steps:
+
+    - name: Download Release Patch Artifact
+      uses: actions/download-artifact@v4
+      with:
+        name: ${{ inputs.release-patch-name }}
+
+    - name: Apply The Release Patch
+      shell: bash
+      run: |
+        git am --committer-date-is-author-date ${{ inputs.release-patch-name }}

toolr-0.9.0/.github/actions/configure-git/action.yml

@@ -0,0 +1,12 @@
+name: Configure Git
+description: Configure git
+
+runs:
+  using: composite
+
+  steps:
+    - name: Configure Git
+      shell: bash
+      run: |
+        git config user.name "github-actions[bot]"
+        git config user.email "github-actions[bot]@users.noreply.github.com"

toolr-0.9.0/.github/actions/prepare-release/action.yml

@@ -0,0 +1,163 @@
+name: Prepare Release
+description: Prepare a release of ToolR
+
+inputs:
+  release-version:
+    required: false
+    description: 'Release version to prepare'
+
+  release-type:
+    required: false
+    description: 'Release type to prepare'
+    default: 'dev'
+    choices:
+      - 'major'
+      - 'minor'
+      - 'patch'
+      - 'dev'
+
+outputs:
+  release-version:
+    description: 'Prepared release version'
+    value: ${{ steps.bump-version.outputs.release-version }}
+
+  release-patch-name:
+    description: 'Name of the release patch'
+    value: ${{ steps.bump-version.outputs.release-patch-name }}
+
+  release-notes-filename:
+    description: 'Name of the release notes file'
+    value: ${{ steps.prepare-release-notes.outputs.release-notes-filename }}
+
+  release-tarball-name:
+    description: 'Name of the release tarball'
+    value: ${{ steps.create-source-tarball.outputs.release-tarball-name }}
+
+runs:
+  using: composite
+
+  steps:
+
+    - name: Setup Virtual Environment
+      uses: ./.github/actions/setup-virtualenv
+      with:
+        cache-prefix: prepare-release
+        python-version: "3.11"
+        uv-sync-args: "--group docs"
+
+    - name: Setup Pre-Commit
+      uses: ./.github/actions/setup-pre-commit
+
+    - name: Bump Version
+      id: bump-version
+      shell: bash
+      run: |
+        if [ -z "${{ inputs.release-version }}" ]; then
+          echo "No release version provided, bumping version based on release type: ${{ inputs.release-type }}"
+          RELEASE_VERSION=$(uv run toolr version bump --${{ inputs.release-type }} --write --check-existing-tag)
+        else
+          echo "Using provided release version: ${{ inputs.release-version }}"
+          RELEASE_VERSION=$(uv run toolr version bump ${{ inputs.release-version }} --write --check-existing-tag)
+        fi
+
+    - name: Generate changelog for GH release
+      id: git-cliff
+      uses: orhun/git-cliff-action@v4
+      with:
+        config: cliff.toml
+        args: --unreleased --strip all
+      env:
+        OUTPUT: .release-changes.md
+        GITHUB_REPO: ${{ github.repository }}
+
+    - name: Prepare GH Release changelog
+      id: prepare-release-notes
+      shell: bash
+      run: |
+        tail -n +3 .release-changes.md > release-notes.md
+        echo "release-notes-filename=release-notes.md" >> "$GITHUB_OUTPUT"
+
+    - name: Upload Release Notes Artifact
+      id: upload-release-notes
+      uses: actions/upload-artifact@v4
+      with:
+        name: ${{ steps.prepare-release-notes.outputs.release-notes-filename }}
+        path: ${{ steps.prepare-release-notes.outputs.release-notes-filename }}
+        retention-days: 7
+        if-no-files-found: error
+
+    - name: Attest release notes artifact
+      uses: actions/attest-build-provenance@v3
+      with:
+        subject-name: ${{ steps.prepare-release-notes.outputs.release-notes-filename }}
+        subject-digest: sha256:${{ steps.upload-release-notes.outputs.artifact-digest }}
+
+    - name: Update CHANGELOG.md
+      uses: orhun/git-cliff-action@v4
+      with:
+        config: cliff.toml
+        args: --verbose --unreleased --tag '${{ env.RELEASE_VERSION }}' --prepend CHANGELOG.md
+      env:
+        GITHUB_REPO: ${{ github.repository }}
+
+    - name: Show Changes Diff
+      shell: bash
+      run: |
+        git diff --color
+
+    - name: Commit changes
+      shell: bash
+      run: |
+        # Add the CHANGELOG.md file to the commit
+        git add CHANGELOG.md
+        # Run pre-commit against the changes
+        pre-commit run --all-files --show-diff-on-failure --color=always || true
+        # Commit the changes
+        git commit -am "chore(release): Prepare for ${{ env.RELEASE_VERSION }} release"
+
+    - name: Tag the release
+      shell: bash
+      run: |
+        git tag -a "${{ env.RELEASE_VERSION }}" -m "Release ${{ env.RELEASE_VERSION }}"
+
+    - name: Create Release Patch
+      shell: bash
+      run: |
+        git format-patch --keep-subject --binary --stdout HEAD^ > toolr-${{ env.RELEASE_VERSION }}.patch
+
+    - name: Upload Changes Diff Artifact
+      id: upload-release-patch
+      uses: actions/upload-artifact@v4
+      with:
+        name: toolr-${{ env.RELEASE_VERSION }}.patch
+        path: toolr-${{ env.RELEASE_VERSION }}.patch
+        retention-days: 7
+        if-no-files-found: error
+
+    - name: Attest release patch artifact
+      uses: actions/attest-build-provenance@v3
+      with:
+        subject-name: toolr-${{ env.RELEASE_VERSION }}.patch
+        subject-digest: sha256:${{ steps.upload-release-patch.outputs.artifact-digest }}
+
+    - name: Create Source Tarball
+      id: create-source-tarball
+      shell: bash
+      run: |
+        uv build --sdist
+        echo "release-tarball-name=$(ls dist/ | grep gz)" >> "$GITHUB_OUTPUT"
+
+    - name: Upload Source Tarball Artifact
+      id: upload-source-tarball
+      uses: actions/upload-artifact@v4
+      with:
+        name: ${{ steps.create-source-tarball.outputs.release-tarball-name }}
+        path: dist/${{ steps.create-source-tarball.outputs.release-tarball-name }}
+        retention-days: 7
+        if-no-files-found: error
+
+    - name: Attest source tarball artifact
+      uses: actions/attest-build-provenance@v3
+      with:
+        subject-name: ${{ steps.create-source-tarball.outputs.release-tarball-name }}
+        subject-digest: sha256:${{ steps.upload-source-tarball.outputs.artifact-digest }}

toolr-0.9.0/.github/actions/setup-pre-commit/action.yml

@@ -0,0 +1,63 @@
+name: setup-pre-commit
+description: Setup 'pre-commit'
+
+inputs:
+  version:
+    description: Pre-commit version to install
+    default: "4.3.0"
+  rust-toolchain:
+    required: true
+    description: Rust toolchain to install
+    default: stable
+  rust-components:
+    required: true
+    description: Rust components to install
+    default: clippy,rustfmt
+
+
+runs:
+  using: composite
+
+  steps:
+    - name: Setup pre-commit home
+      shell: bash
+      id: setup-pre-commit-home
+      run: |
+        PRE_COMMIT_HOME=${{ github.workspace }}/.cache/pre-commit
+        echo "pre-commit-home=${PRE_COMMIT_HOME}" >> "$GITHUB_OUTPUT"
+        echo "PRE_COMMIT_HOME=${PRE_COMMIT_HOME}" >> "$GITHUB_ENV"
+
+    - name: Setup Rust Toolchain
+      uses: actions-rust-lang/setup-rust-toolchain@v1
+      with:
+        toolchain: ${{ inputs.rust-toolchain }}
+        components: ${{ inputs.rust-components }}
+
+    - name: Install pre-commit
+      shell: bash
+      run: |
+        pip install pre-commit==${{ inputs.version }}
+
+    - name: Get Python version checksum
+      id: python-version-checksum
+      shell: bash
+      run: |
+        echo "version-sha256sum=$(python --version --version | sha256sum | cut -d ' ' -f1)" >> "$GITHUB_OUTPUT"
+
+    - name: Get pre-commit version checksum
+      id: pre-commit-version-checksum
+      shell: bash
+      run: |
+        echo "version-sha256sum=$(pre-commit --version | sha256sum | cut -d ' ' -f1)" >> "$GITHUB_OUTPUT"
+
+    - name: Set up cache
+      uses: actions/cache@v4
+      with:
+        path: ${{ steps.setup-pre-commit-home.outputs.pre-commit-home }}
+        key: >-
+          pre-commit-home|${{ runner.os }}|${{ steps.python-version-checksum.outputs.version-sha256sum }}|${{ steps.pre-commit-version-checksum.outputs.version-sha256sum }}|${{ hashFiles('.pre-commit-config.yaml') }}
+
+    - name: Install pre-commit hooks
+      shell: bash
+      run: |
+        pre-commit install --install-hooks

toolr-0.9.0/.github/actions/setup-virtualenv/action.yml

@@ -0,0 +1,79 @@
+name: Setup UV
+description: Setup UV for a given Python version
+
+inputs:
+  python-version:
+    required: true
+    description: 'Python version to use'
+
+  cache-prefix:
+    required: true
+    description: "The prefix to use for the cache key"
+
+  uv-version:
+    default: ""
+    description: "The version of uv to install e.g., `0.5.0` Defaults to the version in pyproject.toml or 'latest'."
+
+  uv-sync-args:
+    default: "--all-extras --dev"
+    description: "The arguments to pass to the uv sync command. e.g., `--group docs` or `--dev`"
+
+outputs:
+  uv-version:
+    description: "The version of uv installed"
+    value: ${{ steps.install-uv.outputs.uv-version }}
+
+  python-version-checksum:
+    description: "The checksum of the Python version"
+    value: ${{ steps.python-version-checksum.outputs.version-sha256sum }}
+
+  uv-version-checksum:
+    description: "The checksum of the UV version"
+    value: ${{ steps.uv-version-checksum.outputs.version-sha256sum }}
+
+runs:
+  using: composite
+  steps:
+    - name: Install Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ inputs.python-version }}
+
+    - name: Get Python version checksum
+      id: python-version-checksum
+      shell: bash
+      run: |
+        VERSION_SHA256SUM=$(python --version --version | sha256sum | cut -d ' ' -f 1)
+        echo "VERSION_SHA256SUM=$VERSION_SHA256SUM"
+        echo "version-sha256sum=$VERSION_SHA256SUM" >> "$GITHUB_OUTPUT"
+
+    - name: Install uv
+      id: install-uv
+      uses: astral-sh/setup-uv@v6
+      with:
+        version: ${{ inputs.uv-version }}
+
+    - name: Get UV version checksum
+      id: uv-version-checksum
+      shell: bash
+      run: |
+        VERSION_SHA256SUM=$(uv --version | sha256sum | cut -d ' ' -f 1)
+        echo "VERSION_SHA256SUM=$VERSION_SHA256SUM"
+        echo "version-sha256sum=$VERSION_SHA256SUM" >> "$GITHUB_OUTPUT"
+
+    - name: Set up cache
+      uses: actions/cache@v4
+      with:
+        path: .venv
+        key: >-
+          venv|
+          ${{ runner.os }}|
+          ${{ inputs.cache-prefix }}|
+          ${{ steps.python-version-checksum.outputs.version-sha256sum }}|
+          ${{ steps.uv-version-checksum.outputs.version-sha256sum }}|
+          ${{ hashFiles('**/uv.lock') }}
+
+    - name: Install Python Dependencies
+      shell: bash
+      run: |
+        uv sync ${{ inputs.uv-sync-args }}

toolr-0.9.0/.github/dependabot.yml

@@ -0,0 +1,26 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - dependencies:github-actions
+    assignees:
+      - s0undt3ch
+  - package-ecosystem: "cargo"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - dependencies:rust
+    assignees:
+      - s0undt3ch
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - dependencies:python
+    assignees:
+      - s0undt3ch

toolr-0.9.0/.github/workflows/build.yml

@@ -0,0 +1,68 @@
+name: Build
+
+on:
+  workflow_call:
+    inputs:
+      display-name:
+        required: true
+        type: string
+        description: 'Display name for the build job'
+      release-tarball-name:
+        required: true
+        type: string
+        description: 'Release tarball name'
+      platform-matrix:
+        required: true
+        type: string
+        description: 'Platform matrix as JSON string'
+
+jobs:
+  build:
+    name: ${{ inputs.display-name }} (${{ matrix.python }}, ${{ matrix.platform.name }})
+    runs-on: ${{ matrix.platform.os }}
+    permissions:
+      id-token: write
+      contents: read
+      attestations: write
+    strategy:
+      fail-fast: false
+      matrix:
+        platform: ${{ fromJson(inputs.platform-matrix) }}
+        python:
+          - "cp311"
+          - "cp312"
+          - "cp313"
+
+    defaults:
+      run:
+        shell: bash
+
+    steps:
+      - name: Download Source Tarball Artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: ${{ inputs.release-tarball-name }}
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+        if: ${{ matrix.platform.emulation }}
+        with:
+          platforms: all
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v3.1.4
+        env:
+          CIBW_ARCHS_LINUX: all
+          CIBW_BUILD: ${{ matrix.python }}-${{ matrix.platform.name }}
+        with:
+          package-dir: ${{ inputs.release-tarball-name }}
+
+      - name: Attest build provenance
+        uses: actions/attest-build-provenance@v3
+        with:
+          subject-path: wheelhouse/*.whl
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: cibw-wheel-${{ matrix.python }}-${{ matrix.platform.name }}
+          path: wheelhouse/*.whl