fastmcp-extensions 0.1.0__tar.gz

fastmcp_extensions-0.1.0/.github/dependabot.yml

@@ -0,0 +1,35 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: "/" # Location of package manifests
+    commit-message:
+      prefix: "chore(deps): "
+    schedule:
+      interval: daily
+    labels:
+      - chore
+      - dependencies
+    open-pull-requests-limit: 8 # default is 5
+
+  - package-ecosystem: github-actions
+    open-pull-requests-limit: 5 # default is 5
+    directory: "/"
+    commit-message:
+      prefix: "ci(deps): "
+    schedule:
+      interval: monthly
+    labels:
+      - ci
+      - dependencies
+    groups:
+      # allow combining github-actions updates into a single PR
+      minor-and-patch:
+        applies-to: version-updates
+        update-types:
+          - patch
+          - minor

fastmcp_extensions-0.1.0/.github/pr-welcome-message.md

@@ -0,0 +1,32 @@
+🎉 **Thanks for opening this pull request!**
+
+Your contribution is appreciated. Here are some helpful commands you can use:
+
+## Quick Commands
+- `/autofix` - Auto-format and fix linting issues (ruff format + ruff check --fix)
+- `/lock` - Update the uv.lock file with latest dependencies
+
+## Available Poe Tasks
+You can run any of these tasks using the slash command: `/poe <task-name>`
+
+### Core Tasks
+- `/poe test` - Run all tests
+- `/poe test-fast` - Run tests with fast exit on first failure
+- `/poe lint` - Check code style and quality  
+- `/poe format` - Format code with ruff
+- `/poe deps` - Check for unused and missing dependencies
+- `/poe check` - Run format check, linting, dependency check, and tests
+
+### Quick Fixes
+- `/poe fix` - Auto-format and fix linting issues
+- `/poe clean` - Clean up build artifacts and cache
+
+### Build & Install
+- `/poe build` - Build the package
+- `/poe install` - Install with development dependencies
+
+### Other Commands
+- `/poe version` - Show package version
+- `/poe pre-commit` - Run pre-commit style checks
+
+The CI will automatically run tests when you push commits. Happy coding! 🚀

fastmcp_extensions-0.1.0/.github/release-drafter.yml

@@ -0,0 +1,81 @@
+name-template: "v$RESOLVED_VERSION"
+tag-template: "v$RESOLVED_VERSION"
+categories:
+  - title: "New Features ✨"
+    labels:
+      - "feature"
+      - "enhancement"
+  - title: "Bug Fixes 🐛"
+    labels:
+      - "fix"
+      - "bugfix"
+      - "bug"
+  - title: "Under the Hood ⚙️"
+    labels:
+      - "chore"
+      - "ci"
+      - "refactor"
+      - "testing"
+  - title: "Documentation 📖"
+    label: "docs"
+change-template: "- $TITLE (#$NUMBER)"
+change-title-escapes: '\<*_&' # You can add # and @ to disable mentions, and add ` to disable code blocks.
+version-resolver:
+  minor:
+    labels:
+      - "enhancement"
+      - "feature"
+      - "breaking"
+  # Semver rules are different before "1.0" If your project is v0.x, you
+  # don't want to auto-bump to 1.0.
+  # Uncomment and dedent if when/if you want to auto-select a major version
+  # bump.
+  # major:
+  #   labels:
+  #     - "breaking"
+  patch:
+    labels:
+      - "bug"
+      - "bugfix"
+      - "fix"
+      - "chore"
+      - "ci"
+      - "docs"
+      - "refactor"
+      - "testing"
+      - "dependencies"
+      - "security"
+  default: patch
+template: |
+  $CHANGES
+autolabeler:
+  - label: "chore"
+    title:
+      - '/^chore(\(.*\))?\:/i'
+  - label: "testing"
+    title:
+      - '/^tests(\(.*\))?\:/i'
+  - label: "ci"
+    title:
+      - '/^ci(\(.*\))?\:/i'
+  - label: "bug"
+    title:
+      - '/^fix(\(.*\))?\:/i'
+  - label: "enhancement"
+    title:
+      - '/^feat(\(.*\))?/i'
+  - label: "docs"
+    title:
+      - '/^docs(\(.*\))?\:/i'
+  - label: "security"
+    title:
+      - '/^security(\(.*\))?\:/i'
+      - '/^fix(\(security\))?\:/i'
+  - label: "dependencies"
+    title:
+      - '/^chore\(deps\)\:/i'
+      - '/^build\(deps\)\:/i'
+  - label: "breaking"
+    title:
+      # Match conventional commit breaking change syntax: feat!: or fix!: etc.
+      - '/^[a-z]+(\([^)]+\))?!:/i'

fastmcp_extensions-0.1.0/.github/workflows/autofix-command.yml

@@ -0,0 +1,37 @@
+name: On-Demand Fix
+
+on:
+  workflow_dispatch:
+    inputs:
+      pr:
+        description: "PR Number"
+        type: string
+        required: false
+      comment-id:
+        description: "Comment ID (Optional)"
+        type: string
+        required: false
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  run-autofix-command:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Authenticate as GitHub App (if available)
+        uses: actions/create-github-app-token@v2
+        id: get-app-token
+        continue-on-error: true
+        with:
+          app-id: ${{ secrets.OCTAVIA_BOT_APP_ID }}
+          private-key: ${{ secrets.OCTAVIA_BOT_PRIVATE_KEY }}
+
+      - name: Run Poe Autofix Command
+        uses: aaronsteers/poe-command-processor@v1.3.3
+        with:
+          pr: ${{ github.event.inputs.pr }}
+          comment-id: ${{ github.event.inputs.comment-id }}
+          github-token: ${{ steps.get-app-token.outputs.token || secrets.GITHUB_TOKEN }}
+          command: autofix

fastmcp_extensions-0.1.0/.github/workflows/format-check.yml

@@ -0,0 +1,31 @@
+name: Format Check
+
+on:
+  push:
+    branches:
+      - main
+  pull_request: {}
+
+jobs:
+  ruff-format-check:
+    name: Ruff Format Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v2
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Check code format
+        run: uv run ruff format --diff .

fastmcp_extensions-0.1.0/.github/workflows/lint-check.yml

@@ -0,0 +1,54 @@
+name: Lint Check
+
+on:
+  push:
+    branches:
+      - main
+  pull_request: {}
+
+jobs:
+  ruff-lint-check:
+    name: Ruff Lint Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v2
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run lint check
+        run: uv run ruff check .
+
+  deptry-check:
+    name: Dependency Analysis
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v2
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run dependency analysis
+        run: uv run deptry .

fastmcp_extensions-0.1.0/.github/workflows/lock-command.yml

@@ -0,0 +1,37 @@
+name: On-Demand Lock
+
+on:
+  workflow_dispatch:
+    inputs:
+      pr:
+        description: "PR Number"
+        type: string
+        required: false
+      comment-id:
+        description: "Comment ID (Optional)"
+        type: string
+        required: false
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  run-lock-command:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Authenticate as GitHub App (if available)
+        uses: actions/create-github-app-token@v2
+        id: get-app-token
+        continue-on-error: true
+        with:
+          app-id: ${{ secrets.OCTAVIA_BOT_APP_ID }}
+          private-key: ${{ secrets.OCTAVIA_BOT_PRIVATE_KEY }}
+
+      - name: Run Poe Lock Command
+        uses: aaronsteers/poe-command-processor@v1.3.3
+        with:
+          pr: ${{ github.event.inputs.pr }}
+          comment-id: ${{ github.event.inputs.comment-id }}
+          github-token: ${{ steps.get-app-token.outputs.token || secrets.GITHUB_TOKEN }}
+          command: lock

fastmcp_extensions-0.1.0/.github/workflows/poe-command.yml

@@ -0,0 +1,34 @@
+name: On-Demand Poe Task
+
+on:
+  workflow_dispatch:
+    inputs:
+      comment-id:
+        description: "Optional comment-id of the slash command. Ignore if not applicable."
+        required: false
+      pr:
+        description: "PR Number"
+        required: false
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  run-poe-command:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Authenticate as GitHub App (if available)
+        uses: actions/create-github-app-token@v2
+        id: get-app-token
+        continue-on-error: true
+        with:
+          app-id: ${{ secrets.OCTAVIA_BOT_APP_ID }}
+          private-key: ${{ secrets.OCTAVIA_BOT_PRIVATE_KEY }}
+
+      - name: Run Poe Slash Command Processor
+        uses: aaronsteers/poe-command-processor@v1.3.3
+        with:
+          pr: ${{ github.event.inputs.pr }}
+          comment-id: ${{ github.event.inputs.comment-id }}
+          github-token: ${{ steps.get-app-token.outputs.token || secrets.GITHUB_TOKEN }}

fastmcp_extensions-0.1.0/.github/workflows/pr-welcome.yml

@@ -0,0 +1,23 @@
+name: PR Welcome
+
+on:
+  pull_request:
+    types: [opened, reopened]
+
+permissions:
+  contents: read
+  issues: write
+  pull-requests: write
+
+jobs:
+  welcome:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Create welcome comment
+        uses: peter-evans/create-or-update-comment@v5
+        with:
+          issue-number: ${{ github.event.pull_request.number }}
+          body-file: .github/pr-welcome-message.md

fastmcp_extensions-0.1.0/.github/workflows/prerelease-command.yml

@@ -0,0 +1,117 @@
+# Prerelease Command Workflow
+#
+# This workflow is triggered by the /prerelease slash command on a PR.
+# It dispatches the publish workflow to build and publish a prerelease version.
+#
+# Usage: Comment `/prerelease` on a PR to trigger this workflow.
+#
+# Requirements:
+# - PyPI Trusted Publisher configured for publish.yml (see publish.yml header for setup)
+
+name: On-Demand Prerelease
+
+on:
+  workflow_dispatch:
+    inputs:
+      pr:
+        description: "PR Number"
+        type: string
+        required: true
+      comment-id:
+        description: "Comment ID (Optional)"
+        type: string
+        required: false
+
+permissions:
+  contents: read
+  pull-requests: write
+  issues: write
+  actions: write
+
+jobs:
+  prerelease:
+    name: Trigger Prerelease Publish
+    runs-on: ubuntu-latest
+    steps:
+      - name: Create URL to the run output
+        id: vars
+        run: echo "run-url=https://github.com/$GITHUB_REPOSITORY/actions/runs/$GITHUB_RUN_ID" >> $GITHUB_OUTPUT
+
+      - name: Append comment with job run link
+        id: first-comment-action
+        if: github.event.inputs.comment-id
+        uses: peter-evans/create-or-update-comment@v4
+        with:
+          comment-id: ${{ github.event.inputs.comment-id }}
+          issue-number: ${{ github.event.inputs.pr }}
+          body: |
+            > **Prerelease Build Started**
+            >
+            > Building and publishing prerelease package from this PR...
+            > [Check job output.](${{ steps.vars.outputs.run-url }})
+
+      - name: Checkout to get latest tag
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Compute prerelease version
+        id: version
+        run: |
+          # Get the latest tag version (strip 'v' prefix if present)
+          LATEST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "v0.0.0")
+          BASE_VERSION=${LATEST_TAG#v}
+          # Create a unique prerelease version using PR number and run ID
+          # Format: {base}.dev{pr_number}{run_id} (e.g., 0.2.0.dev26123456789)
+          PRERELEASE_VERSION="${BASE_VERSION}.dev${{ github.event.inputs.pr }}${{ github.run_id }}"
+          echo "version=$PRERELEASE_VERSION" >> $GITHUB_OUTPUT
+          echo "Computed prerelease version: $PRERELEASE_VERSION"
+
+      - name: Trigger publish workflow
+        id: trigger-publish
+        uses: the-actions-org/workflow-dispatch@v4
+        with:
+          workflow: publish.yml
+          token: ${{ secrets.GITHUB_TOKEN }}
+          # Use refs/pull/<PR>/head for fork compatibility
+          ref: refs/pull/${{ github.event.inputs.pr }}/head
+          wait-for-completion: true
+          wait-for-completion-timeout: 10m
+          display-workflow-run-url: false
+          inputs: >-
+            {
+              "version": "${{ steps.version.outputs.version }}",
+              "publish_to_pypi": "true"
+            }
+
+      - name: Append success comment
+        if: success() && github.event.inputs.comment-id
+        uses: peter-evans/create-or-update-comment@v4
+        with:
+          comment-id: ${{ steps.first-comment-action.outputs.comment-id }}
+          issue-number: ${{ github.event.inputs.pr }}
+          reactions: rocket
+          body: |
+            > **Prerelease Published to TestPyPI**
+            >
+            > Version: `${{ steps.version.outputs.version }}`
+            > [View publish workflow](${{ steps.trigger-publish.outputs.workflow-url }})
+            >
+            > Install and test with any of the following:
+            > ```bash
+            > uv tool install fastmcp-extensions==${{ steps.version.outputs.version }} --index-url https://test.pypi.org/simple/
+            > uv add fastmcp-extensions==${{ steps.version.outputs.version }} --index-url https://test.pypi.org/simple/
+            > ```
+
+      - name: Append failure comment
+        if: failure() && github.event.inputs.comment-id
+        uses: peter-evans/create-or-update-comment@v4
+        with:
+          comment-id: ${{ steps.first-comment-action.outputs.comment-id }}
+          issue-number: ${{ github.event.inputs.pr }}
+          reactions: confused
+          body: |
+            > **Prerelease Build/Publish Failed**
+            >
+            > The prerelease encountered an error.
+            > [Check job output](${{ steps.vars.outputs.run-url }}) for details.

fastmcp_extensions-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,199 @@
+# This workflow builds the python package and publishes to PyPI.
+#
+# Triggers:
+# - release: published - When user clicks "Publish" on a draft release (downloads pre-built assets)
+# - workflow_dispatch - Manual trigger for prereleases (builds fresh)
+#
+# Authentication: This workflow expects GitHub OIDC for passwordless PyPI publishing.
+# For more info: https://docs.pypi.org/trusted-publishers/
+
+name: Publish Package
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      version:
+        description: >
+          Note that this workflow is intended for prereleases. For public-facing stable releases,
+          please use the GitHub Releases workflow instead.
+          For prereleases, please leave the version blank to use the detected version. Alternatively,
+          you can override the dynamic versioning for special use cases.
+        required: false
+      publish_to_pypi:
+        description: "Publish to PyPI. If true, the workflow will publish to PyPI."
+        type: boolean
+        required: true
+        default: true
+
+jobs:
+  # Download pre-built assets from the release (only on release: published)
+  download_release_assets:
+    name: Download Release Assets
+    runs-on: ubuntu-latest
+    if: github.event_name == 'release'
+    steps:
+      - name: Download wheel and sdist from release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          mkdir -p dist
+          gh release download "${{ github.event.release.tag_name }}" \
+            --repo "${{ github.repository }}" \
+            --pattern "*.whl" \
+            --pattern "*.tar.gz" \
+            --dir dist
+          echo "Downloaded assets:"
+          ls -la dist/
+
+      - name: Verify assets were downloaded
+        run: |
+          if [ ! -f dist/*.whl ]; then
+            echo "Error: No wheel file found in release assets"
+            exit 1
+          fi
+          if [ ! -f dist/*.tar.gz ]; then
+            echo "Error: No sdist file found in release assets"
+            exit 1
+          fi
+          echo "Assets verified successfully"
+
+      - uses: actions/upload-artifact@v5
+        with:
+          name: Packages-${{ github.run_id }}
+          path: |
+            dist/*.whl
+            dist/*.tar.gz
+
+    outputs:
+      VERSION: ${{ github.event.release.tag_name }}
+
+  # Build fresh package (only on workflow_dispatch, NOT on release)
+  build:
+    name: Build Python Package
+    runs-on: ubuntu-latest
+    if: github.event_name != 'release'
+    steps:
+      - name: Checkout Repo
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Detect Prerelease Version using Dunamai
+        uses: mtkennerly/dunamai-action@v1
+        with:
+          args: --format "{base}.post{distance}.dev${{ github.run_id }}"
+          env-var: DETECTED_VERSION
+
+      - name: Detect Release Tag Version from git ref ('${{ github.ref_name }}')
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          echo "Overriding Dunamai detected version: '${{ env.DETECTED_VERSION || 'none' }}'"
+          # Extract the version from the git ref
+          DETECTED_VERSION=${{ github.ref_name }}
+          # Remove the 'v' prefix if it exists
+          DETECTED_VERSION="${DETECTED_VERSION#v}"
+          echo "Setting detected version to '$DETECTED_VERSION'"
+          echo "DETECTED_VERSION=${DETECTED_VERSION}" >> $GITHUB_ENV
+
+      - name: Validate and set VERSION (detected='${{ env.DETECTED_VERSION }}', input='${{ github.event.inputs.version || 'none' }}')
+        id: set_version
+        run: |
+          INPUT_VERSION=${{ github.event.inputs.version }}
+          echo "Version input set to '${INPUT_VERSION}'"
+          # Exit with success if both detected and input versions are empty
+          if [ -z "${DETECTED_VERSION:-}" ] && [ -z "${INPUT_VERSION:-}" ]; then
+            echo "No version detected or input. Will publish to SHA tag instead."
+            echo 'VERSION=' >> $GITHUB_ENV
+            exit 0
+          fi
+          # Remove the 'v' prefix if it exists
+          INPUT_VERSION="${INPUT_VERSION#v}"
+          # Fail if detected version is non-empty and different from the input version
+          if [ -n "${DETECTED_VERSION:-}" ] && [ -n "${INPUT_VERSION:-}" ] && [ "${DETECTED_VERSION}" != "${INPUT_VERSION}" ]; then
+            echo "Warning: Version input '${INPUT_VERSION}' does not match detected version '${DETECTED_VERSION}'."
+            echo "Using input version '${INPUT_VERSION}' instead."
+          fi
+          # Set the version to the input version if non-empty, otherwise the detected version
+          VERSION="${INPUT_VERSION:-$DETECTED_VERSION}"
+          # Fail if the version is still empty
+          if [ -z "$VERSION" ]; then
+            echo "Error: VERSION is not set. Ensure the tag follows the format 'refs/tags/vX.Y.Z'."
+            exit 1
+          fi
+          echo "Setting version to '$VERSION'"
+          echo "VERSION=${VERSION}" >> $GITHUB_ENV
+          echo "VERSION=${VERSION}" >> $GITHUB_OUTPUT
+          # Check if version is a prerelease version (will not tag 'latest')
+          if [[ "${VERSION}" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "IS_PRERELEASE=false" >> $GITHUB_ENV
+            echo "IS_PRERELEASE=false" >> $GITHUB_OUTPUT
+          else
+            echo "IS_PRERELEASE=true" >> $GITHUB_ENV
+            echo "IS_PRERELEASE=true" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v2
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build package
+        env:
+          # Use UV_DYNAMIC_VERSIONING_BYPASS to override the version in pyproject.toml
+          # This ensures the build matches the detected/validated VERSION.
+          UV_DYNAMIC_VERSIONING_BYPASS: ${{ env.VERSION }}
+        run: uv build
+
+      - uses: actions/upload-artifact@v5
+        with:
+          name: Packages-${{ github.run_id }}
+          path: |
+            dist/*.whl
+            dist/*.tar.gz
+
+    outputs:
+      VERSION: ${{ steps.set_version.outputs.VERSION }}
+      IS_PRERELEASE: ${{ steps.set_version.outputs.IS_PRERELEASE }}
+
+  publish_to_pypi:
+    name: Publish Package to PyPI
+    runs-on: ubuntu-latest
+    # Depend on whichever job ran (build for dispatch, download for release)
+    needs: [build, download_release_assets]
+    # Always run if at least one of the needed jobs succeeded
+    if: |
+      always() &&
+      (needs.build.result == 'success' || needs.download_release_assets.result == 'success') &&
+      (
+        github.event_name == 'release' ||
+        (github.event_name == 'workflow_dispatch' && github.event.inputs.publish_to_pypi == 'true')
+      )
+    permissions:
+      id-token: write
+      contents: write
+    environment:
+      name: PyPI
+      url: https://pypi.org/p/fastmcp-extensions/
+    env:
+      VERSION: ${{ needs.build.outputs.VERSION || needs.download_release_assets.outputs.VERSION }}
+      IS_PRERELEASE: ${{ needs.build.outputs.IS_PRERELEASE || 'false' }}
+    steps:
+      - uses: actions/download-artifact@v6
+        with:
+          name: Packages-${{ github.run_id }}
+          path: dist
+
+      # Note: Wheel upload to GitHub release is handled by release-drafter.yml
+      # during the draft stage (before publish). This avoids the "immutable release"
+      # error that occurs when trying to upload assets after a release is published.
+
+      - name: Publish to PyPI
+        # Uses GitHub OIDC for passwordless authentication (see header comment)
+        uses: pypa/gh-action-pypi-publish@v1.13.0