clincalc 0.2.2__tar.gz

clincalc-0.2.2/.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: bawmedical
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+thanks_dev: # Replace with a single thanks.dev username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

clincalc-0.2.2/.github/dependabot.yml

@@ -0,0 +1,15 @@
+# Update schedule for GitHub Actions and Rust/Cargo dependencies.
+
+version: 2
+updates:
+  # GitHub Actions, weekly.
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+
+  # Rust/Cargo dependencies, daily.
+  - package-ecosystem: "cargo"
+    directory: "/"
+    schedule:
+      interval: "daily"

clincalc-0.2.2/.github/workflows/auto-tag.yml

@@ -0,0 +1,122 @@
+# SPDX-FileCopyrightText: 2026 Marcus Baw and Baw Medical Ltd
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+name: Auto-tag on version bump
+
+# When a push to main bumps the workspace version in Cargo.toml, create and push
+# the matching `v<version>` tag, then invoke the binary release, crates.io, and
+# PyPI publish workflows with that tag.
+#
+# The downstream workflows are invoked via `workflow_call` rather than by relying
+# on the tag push to trigger them, because pushes performed via the default
+# GITHUB_TOKEN do not trigger downstream workflows (GitHub's anti-recursion
+# guard). This is the auto-tag cascade documented in
+# ~/code/house-style/distribution.md.
+
+on:
+  push:
+    branches: [main]
+
+concurrency:
+  group: auto-tag-${{ github.ref }}
+  cancel-in-progress: false
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  tag:
+    name: Detect version bump and create tag
+    runs-on: ubuntu-latest
+    outputs:
+      tag: ${{ steps.bump.outputs.tag }}
+      bumped: ${{ steps.bump.outputs.bumped }}
+      created: ${{ steps.create.outputs.created }}
+
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          fetch-depth: 2
+          persist-credentials: true
+
+      - name: Detect Cargo.toml version change
+        id: bump
+        run: |
+          new=$(grep -m1 '^version = "' Cargo.toml | cut -d'"' -f2)
+          old=$(git show HEAD~1:Cargo.toml 2>/dev/null \
+                  | grep -m1 '^version = "' | cut -d'"' -f2 || echo "")
+
+          if [ -z "$new" ]; then
+            echo "::warning::Could not read version from Cargo.toml"
+            echo "bumped=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          if [ "$new" = "$old" ]; then
+            echo "No version change ($new == $old) - nothing to tag."
+            echo "bumped=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          tag="v$new"
+          if git ls-remote --exit-code --tags origin "refs/tags/$tag" >/dev/null 2>&1; then
+            echo "Tag $tag already exists on origin - assuming a previous run created it."
+            echo "bumped=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          echo "Cargo.toml: $old -> $new"
+          echo "tag=$tag" >> "$GITHUB_OUTPUT"
+          echo "bumped=true" >> "$GITHUB_OUTPUT"
+
+      - name: Create and push tag
+        id: create
+        if: steps.bump.outputs.bumped == 'true'
+        run: |
+          tag="${{ steps.bump.outputs.tag }}"
+          if git ls-remote --exit-code --tags origin "refs/tags/$tag" >/dev/null 2>&1; then
+            echo "Tag $tag already exists on origin - another run won the race."
+            echo "created=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git tag -a "$tag" -m "Release $tag"
+
+          if git push origin "refs/tags/$tag"; then
+            echo "created=true" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          if git ls-remote --exit-code --tags origin "refs/tags/$tag" >/dev/null 2>&1; then
+            echo "Tag $tag now exists on origin - another run won the race."
+            echo "created=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          exit 1
+
+  release:
+    needs: tag
+    if: needs.tag.outputs.created == 'true'
+    uses: ./.github/workflows/release.yml
+    with:
+      tag: ${{ needs.tag.outputs.tag }}
+    secrets: inherit
+
+  publish-crates:
+    needs: tag
+    if: needs.tag.outputs.created == 'true'
+    uses: ./.github/workflows/publish-crates.yml
+    with:
+      tag: ${{ needs.tag.outputs.tag }}
+    secrets: inherit
+
+  publish-python:
+    needs: tag
+    if: needs.tag.outputs.created == 'true'
+    uses: ./.github/workflows/publish-python.yml
+    with:
+      tag: ${{ needs.tag.outputs.tag }}
+    secrets: inherit

clincalc-0.2.2/.github/workflows/ci.yml

@@ -0,0 +1,65 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  test:
+    name: fmt, clippy, test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+
+      - name: Install Rust toolchain (stable, with rustfmt and clippy)
+        uses: dtolnay/rust-toolchain@67ef31d5b988238dd797d409d6f9574278e20537 # stable
+        with:
+          toolchain: stable
+          components: rustfmt, clippy
+
+      - uses: Swatinem/rust-cache@c19371144df3bb44fab255c43d04cbc2ab54d1c4 # v2.9.1
+
+      - name: Formatting
+        run: cargo fmt --all --check
+
+      - name: Clippy (default features)
+        run: cargo clippy --all-targets -- -D warnings
+
+      - name: Clippy (MCP feature)
+        run: cargo clippy --all-targets --features mcp -- -D warnings
+
+      - name: Tests (default features)
+        run: cargo test
+
+      - name: Tests (leaf engine)
+        run: cargo test --no-default-features
+
+      - name: Tests (MCP feature)
+        run: cargo test --features mcp
+
+  audit:
+    name: Security audit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+
+      # Prebuilt binary (seconds) rather than a from-source `cargo install`.
+      - name: Install cargo-audit
+        uses: taiki-e/install-action@16b05812d776ae1dfaabc8277e421fb6d2506419 # v2.82.7
+        with:
+          tool: cargo-audit
+
+      # Fails on any RustSec advisory affecting the locked tree, so a vulnerable
+      # dependency is caught here rather than waiting on a Dependabot email. A
+      # genuinely unfixable transitive advisory can be quarantined in audit.toml
+      # (`[advisories] ignore = ["RUSTSEC-XXXX-NNNN"]`) with a note.
+      - name: cargo audit
+        run: cargo audit

clincalc-0.2.2/.github/workflows/docs.yml

@@ -0,0 +1,94 @@
+# Builds and deploys the clincalc documentation site to GitHub Pages.
+#
+# Method: artifact-based deploy (actions/upload-pages-artifact +
+# actions/deploy-pages). The built site is handed straight to GitHub's Pages
+# servers as a workflow artifact - there is no `gh-pages` branch, no orphan
+# history, nothing in `git log --all` that did not come from a real commit.
+#
+# Repo prerequisite (one-off): Settings -> Pages -> Source must be set to
+# "GitHub Actions". If it is set to "Deploy from a branch", deploy-pages
+# fails with "Get Pages site failed". This is set once on the repo and
+# persists.
+#
+# Action SHAs are copied from the sibling repos' docs workflows (the canonical
+# living examples) and carry the matching `# vX.Y.Z` comment per house style.
+
+name: docs
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "docs/**"
+      - "examples/**"
+      - "mkdocs.yml"
+      - "requirements.txt"
+      - ".github/workflows/docs.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.x"
+      - uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6.0.0
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+      - uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          key: zensical-${{ env.cache_id }}
+          path: ~/.cache
+          restore-keys: |
+            zensical-
+      - run: pip install -r requirements.txt
+      - run: zensical build --clean
+
+      # Drop installer proxies at the site root so users can do
+      #   curl -LsSf https://pacharanero.github.io/clincalc/install.sh | sh
+      # instead of the full GitHub Releases URL. The scripts below simply
+      # re-fetch cargo-dist's real installer for the latest release, so they
+      # never go stale between docs deploys.
+      - name: Add installer proxies
+        run: |
+          cat > site/install.sh <<'EOF'
+          #!/bin/sh
+          # clincalc installer proxy - fetches the latest cargo-dist installer.
+          # Source: https://github.com/pacharanero/clincalc
+          set -eu
+          curl --proto '=https' --tlsv1.2 -LsSf \
+            https://github.com/pacharanero/clincalc/releases/latest/download/clincalc-installer.sh \
+            | sh
+          EOF
+          chmod +x site/install.sh
+
+          cat > site/install.ps1 <<'EOF'
+          # clincalc installer proxy - fetches the latest cargo-dist installer.
+          # Source: https://github.com/pacharanero/clincalc
+          irm https://github.com/pacharanero/clincalc/releases/latest/download/clincalc-installer.ps1 | iex
+          EOF
+
+      - uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0
+        with:
+          path: site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5.0.0

clincalc-0.2.2/.github/workflows/publish-crates.yml

@@ -0,0 +1,66 @@
+# SPDX-FileCopyrightText: 2026 Marcus Baw and Baw Medical Ltd
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+name: Publish to crates.io
+
+# Publishes the `clincalc` crate to crates.io on a release tag. Invoked by
+# auto-tag.yml via workflow_call (the cascade); also triggerable manually
+# (workflow_dispatch) or by a `v*` tag push to re-publish a given tag.
+#
+# Needs the CARGO_REGISTRY_TOKEN secret on this repo.
+
+on:
+  workflow_call:
+    inputs:
+      tag:
+        description: "Tag to publish, e.g. v0.1.0"
+        required: true
+        type: string
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Tag to publish, e.g. v0.2.0"
+        required: true
+        type: string
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    name: Publish to crates.io
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          ref: ${{ inputs.tag || github.ref }}
+
+      - name: Install Rust stable
+        uses: dtolnay/rust-toolchain@67ef31d5b988238dd797d409d6f9574278e20537 # stable
+        with:
+          toolchain: stable
+
+      - uses: Swatinem/rust-cache@c19371144df3bb44fab255c43d04cbc2ab54d1c4 # v2.9.1
+
+      - name: Test before publishing (publish is irreversible)
+        run: cargo test --all-features
+
+      - name: Publish clincalc to crates.io
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
+        run: |
+          if cargo publish >publish.log 2>&1; then
+            exit 0
+          fi
+
+          if grep -Eqi "already uploaded|already exists on crates.io index" publish.log; then
+            echo "This crate version is already published on crates.io - treating as success."
+            cat publish.log
+            exit 0
+          fi
+
+          cat publish.log >&2
+          exit 1

clincalc-0.2.2/.github/workflows/publish-python.yml

@@ -0,0 +1,132 @@
+# SPDX-FileCopyrightText: 2026 Marcus Baw and Baw Medical Ltd
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+name: Publish Python package to PyPI
+
+# Builds and publishes the `clincalc` Python wheel/sdist for the tag. Invoked
+# by auto-tag.yml via workflow_call (the cascade); also triggerable manually
+# or by a `v*` tag push to re-publish a given tag.
+#
+# Publishes with PyPI Trusted Publishing via GitHub OIDC. PyPI must trust this
+# repository and workflow; no long-lived API token is stored in GitHub.
+
+on:
+  workflow_call:
+    inputs:
+      tag:
+        description: "Tag to publish, e.g. v0.1.0"
+        required: true
+        type: string
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Tag to publish, e.g. v0.2.0"
+        required: true
+        type: string
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  linux:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        target: [x86_64, aarch64]
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          ref: ${{ inputs.tag || github.ref }}
+      - uses: PyO3/maturin-action@3e2bdf6ba6453a61e649744019b8a2d906c7eb38 # v1.51.0
+        with:
+          command: build
+          args: --release --locked --target ${{ matrix.target }}-unknown-linux-gnu --out dist --manifest-path Cargo.toml
+          manylinux: auto
+          working-directory: python
+      - name: Upload wheels
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: wheels-linux-${{ matrix.target }}
+          path: python/dist
+
+  windows:
+    runs-on: windows-latest
+    strategy:
+      matrix:
+        target: [x64]
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          ref: ${{ inputs.tag || github.ref }}
+      - uses: PyO3/maturin-action@3e2bdf6ba6453a61e649744019b8a2d906c7eb38 # v1.51.0
+        with:
+          command: build
+          args: --release --locked --target ${{ matrix.target }}-pc-windows-msvc --out dist --manifest-path Cargo.toml
+          working-directory: python
+      - name: Upload wheels
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: wheels-windows-${{ matrix.target }}
+          path: python/dist
+
+  macos:
+    runs-on: macos-latest
+    strategy:
+      matrix:
+        target: [x86_64, aarch64]
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          ref: ${{ inputs.tag || github.ref }}
+      - uses: PyO3/maturin-action@3e2bdf6ba6453a61e649744019b8a2d906c7eb38 # v1.51.0
+        with:
+          command: build
+          args: --release --locked --target ${{ matrix.target }}-apple-darwin --out dist --manifest-path Cargo.toml
+          working-directory: python
+      - name: Upload wheels
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: wheels-macos-${{ matrix.target }}
+          path: python/dist
+
+  sdist:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          ref: ${{ inputs.tag || github.ref }}
+      - uses: PyO3/maturin-action@3e2bdf6ba6453a61e649744019b8a2d906c7eb38 # v1.51.0
+        with:
+          command: sdist
+          args: --out dist --manifest-path Cargo.toml
+          working-directory: python
+      - name: Upload sdist
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: sdist
+          path: python/dist
+
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    needs: [linux, windows, macos, sdist]
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          path: dist
+          pattern: wheels-*
+          merge-multiple: true
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          path: dist
+          pattern: sdist
+          merge-multiple: true
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@6733eb7d741f0b11ec6a39b58540dab7590f9b7d # v1.14.0
+        with:
+          packages-dir: dist