mcp-server-docker-dboeckli 0.6.1__tar.gz

mcp_server_docker_dboeckli-0.6.1/.dockerignore

@@ -0,0 +1 @@
+.venv

mcp_server_docker_dboeckli-0.6.1/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

mcp_server_docker_dboeckli-0.6.1/.github/dependabot.yml

@@ -0,0 +1,11 @@
+# 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: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"

mcp_server_docker_dboeckli-0.6.1/.github/renovate.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": [
+    "config:recommended"
+  ],
+  "github-actions": {
+    "enabled": false
+  },
+  "dependencyDashboard": true,
+  "lockFileMaintenance": {
+    "enabled": true
+  },
+  "packageRules": [
+    {
+      "matchUpdateTypes": [
+        "major"
+      ],
+      "dependencyDashboardApproval": true
+    },
+    {
+      "matchPackageNames": [
+        "python"
+      ],
+      "allowedVersions": ">=3.12.0 <3.13.0"
+    },
+    {
+      "matchManagers": [
+        "pep621"
+      ],
+      "groupName": "Python dependencies"
+    },
+    {
+      "matchManagers": [
+        "dockerfile"
+      ],
+      "groupName": "Docker base images"
+    },
+    {
+      "matchManagers": [
+        "devbox"
+      ],
+      "groupName": "devbox packages"
+    },
+    {
+      "matchManagers": [
+        "devbox"
+      ],
+      "matchPackageNames": [
+        "nodejs"
+      ],
+      "allowedVersions": ">=26.0.0 <27.0.0",
+      "dependencyDashboardApproval": false,
+      "groupName": "Node.js"
+    }
+  ]
+}

mcp_server_docker_dboeckli-0.6.1/.github/rulesets/README.md

@@ -0,0 +1,32 @@
+# Repository rulesets
+
+Versioned copies of the active GitHub rulesets for `main`.
+
+| File | Rules |
+|------|-------|
+| `main-1.json` | `deletion`, `non_fast_forward` |
+| `main-2.json` | `required_linear_history`, `required_status_checks`, `pull_request` |
+
+Adapted from an export of `dboeckli/spring-7-web-services`:
+
+- Branch condition: `refs/heads/master` → `refs/heads/main`
+- Required status check: `build` → `Test & lint`, `Integration tests`, `Docker image`
+- Merge commits disabled in favor of linear history (squash/rebase only)
+- Admin bypass (`RepositoryRole` actor 5) kept so the owner can bypass in emergencies
+
+These files are reference copies. GitHub does not apply them automatically.
+
+## Apply
+
+Create new rulesets (IDs and `source` fields are assigned by the target repository):
+
+```bash
+gh api -X POST repos/{owner}/{repo}/rulesets --input .github/rulesets/main-1.json
+gh api -X POST repos/{owner}/{repo}/rulesets --input .github/rulesets/main-2.json
+```
+
+Update an existing ruleset by ID with `PUT`:
+
+```bash
+gh api -X PUT repos/{owner}/{repo}/rulesets/{id} --input .github/rulesets/main-2.json
+```

mcp_server_docker_dboeckli-0.6.1/.github/rulesets/main-1.json

@@ -0,0 +1,22 @@
+{
+  "name": "main-1",
+  "target": "branch",
+  "enforcement": "active",
+  "conditions": {
+    "ref_name": {
+      "exclude": [],
+      "include": [
+        "refs/heads/main"
+      ]
+    }
+  },
+  "rules": [
+    {
+      "type": "deletion"
+    },
+    {
+      "type": "non_fast_forward"
+    }
+  ],
+  "bypass_actors": []
+}

mcp_server_docker_dboeckli-0.6.1/.github/rulesets/main-2.json

@@ -0,0 +1,62 @@
+{
+  "name": "main-2",
+  "target": "branch",
+  "enforcement": "active",
+  "conditions": {
+    "ref_name": {
+      "exclude": [],
+      "include": [
+        "refs/heads/main"
+      ]
+    }
+  },
+  "rules": [
+    {
+      "type": "required_linear_history"
+    },
+    {
+      "type": "required_status_checks",
+      "parameters": {
+        "strict_required_status_checks_policy": true,
+        "do_not_enforce_on_create": true,
+        "required_status_checks": [
+          {
+            "context": "Test & lint",
+            "integration_id": 15368
+          },
+          {
+            "context": "Integration tests",
+            "integration_id": 15368
+          },
+          {
+            "context": "Docker image",
+            "integration_id": 15368
+          }
+        ]
+      }
+    },
+    {
+      "type": "pull_request",
+      "parameters": {
+        "required_approving_review_count": 1,
+        "dismiss_stale_reviews_on_push": true,
+        "required_reviewers": [],
+        "require_code_owner_review": true,
+        "require_last_push_approval": true,
+        "required_review_thread_resolution": true,
+        "require_extra_approval_for_unattributed_changes": true,
+        "allowed_merge_methods": [
+          "squash",
+          "rebase"
+        ]
+      }
+    }
+  ],
+  "bypass_actors": [
+    {
+      "actor_id": 5,
+      "actor_type": "RepositoryRole",
+      "bypass_mode": "always"
+    }
+  ]
+}

mcp_server_docker_dboeckli-0.6.1/.github/workflows/ci.yml

@@ -0,0 +1,87 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Test & lint
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v7.0.1
+      - uses: astral-sh/setup-uv@v10.3.3
+        with:
+          python-version: "3.12"
+          enable-cache: true
+      - name: Install dependencies
+        run: uv sync --all-groups --frozen
+      - name: Check formatting
+        run: uv run ruff format --check src tests
+      - name: Lint
+        run: uv run ruff check src tests
+      - name: Test
+        run: uv run pytest --cov=mcp_server_docker --cov-report=term-missing --cov-fail-under=90
+
+  integration:
+    name: Integration tests
+    needs: test
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v7.0.1
+      - uses: docker/setup-buildx-action@v4.4.1
+      - uses: astral-sh/setup-uv@v10.3.3
+        with:
+          python-version: "3.12"
+          enable-cache: true
+      - name: Install dependencies
+        run: uv sync --all-groups --frozen
+      - name: Run integration tests
+        run: uv run pytest -o addopts= -m integration
+
+  docker:
+    name: Docker image
+    needs: test
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v7.0.1
+      - uses: docker/setup-buildx-action@v4.4.1
+      - name: Log in to GHCR
+        if: startsWith(github.ref, 'refs/tags/v')
+        uses: docker/login-action@v4.8.0
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v6.2.0
+        with:
+          images: ghcr.io/${{ github.repository }}
+          tags: |
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=raw,value=latest,enable=${{ startsWith(github.ref, 'refs/tags/v') }}
+            type=ref,event=branch
+            type=ref,event=pr
+      - name: Build and push
+        uses: docker/build-push-action@v7.4.0
+        with:
+          context: .
+          push: ${{ startsWith(github.ref, 'refs/tags/v') }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

mcp_server_docker_dboeckli-0.6.1/.github/workflows/release.yml

@@ -0,0 +1,127 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+# Never cancel a release half-way: a cancelled publish leaves a version on PyPI
+# that cannot be reused.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Test & lint
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v7.0.1
+      - uses: astral-sh/setup-uv@v10.3.3
+        with:
+          python-version: "3.12"
+          enable-cache: true
+      - name: Install dependencies
+        run: uv sync --all-groups --frozen
+      - name: Check formatting
+        run: uv run ruff format --check src tests
+      - name: Lint
+        run: uv run ruff check src tests
+      - name: Test
+        run: uv run pytest --cov=mcp_server_docker --cov-report=term-missing --cov-fail-under=90
+
+  build:
+    name: Build distributions
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v7.0.1
+      - uses: astral-sh/setup-uv@v10.3.3
+        with:
+          python-version: "3.12"
+          enable-cache: true
+      - name: Verify the tag matches the package version
+        run: |
+          tag_version="${GITHUB_REF_NAME#v}"
+          code_version="$(sed -n 's/^__version__ = "\(.*\)"$/\1/p' src/mcp_server_docker/_version.py)"
+          echo "tag=$tag_version code=$code_version"
+          if [ -z "$code_version" ] || [ "$tag_version" != "$code_version" ]; then
+            echo "::error::Tag $GITHUB_REF_NAME does not match __version__ '${code_version}' in src/mcp_server_docker/_version.py"
+            exit 1
+          fi
+      - name: Build sdist and wheel
+        run: uv build
+      - name: Verify wheel contents and metadata
+        run: |
+          uv run --no-project python - "$GITHUB_REF_NAME" <<'PY'
+          import glob
+          import sys
+          import zipfile
+          from email.parser import HeaderParser
+
+          expected_version = sys.argv[1].removeprefix("v")
+          wheel = glob.glob("dist/*.whl")[0]
+          archive = zipfile.ZipFile(wheel)
+          names = archive.namelist()
+
+          assert "mcp_server_docker/__init__.py" in names, "package directory missing"
+          entry_points = next(n for n in names if n.endswith("entry_points.txt"))
+          assert "mcp-server-docker" in archive.read(entry_points).decode()
+
+          metadata_path = next(n for n in names if n.endswith("METADATA"))
+          metadata = HeaderParser().parsestr(archive.read(metadata_path).decode())
+          assert metadata["Name"] == "mcp-server-docker-dboeckli", metadata["Name"]
+          assert metadata["Version"] == expected_version, metadata["Version"]
+          print(f"verified {metadata['Name']} {metadata['Version']}")
+          PY
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    name: Publish to PyPI
+    needs: [test, build]
+    runs-on: ubuntu-24.04
+    environment:
+      name: pypi
+      url: https://pypi.org/p/mcp-server-docker-dboeckli
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+
+  release:
+    name: GitHub release
+    needs: publish
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Create or update the release with the distributions attached
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GH_REPO: ${{ github.repository }}
+        run: |
+          if gh release view "$GITHUB_REF_NAME" >/dev/null 2>&1; then
+            gh release upload "$GITHUB_REF_NAME" dist/* --clobber
+          else
+            gh release create "$GITHUB_REF_NAME" dist/* \
+              --verify-tag \
+              --generate-notes \
+              --title "$GITHUB_REF_NAME"
+          fi

mcp_server_docker_dboeckli-0.6.1/.gitignore

@@ -0,0 +1,21 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# IDEs
+.idea/
+
+# Test / coverage artifacts
+.coverage
+htmlcov/
+
+# Superpowers planning artifacts
+.superpowers/
+docs/superpowers/

mcp_server_docker_dboeckli-0.6.1/.python-version

@@ -0,0 +1 @@
+3.12.16

mcp_server_docker_dboeckli-0.6.1/Dockerfile

@@ -0,0 +1,30 @@
+FROM ghcr.io/astral-sh/uv:python3.12-bookworm-slim@sha256:e5b65587bce7de595f299855d7385fe7fca39b8a74baa261ba1b7147afa78e58 AS uv
+
+WORKDIR /app
+
+ENV UV_COMPILE_BYTECODE=1
+
+# Copy from the cache instead of linking since it's a mounted volume
+ENV UV_LINK_MODE=copy
+
+COPY uv.lock pyproject.toml /app/
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --frozen --no-install-project --no-dev --no-editable
+
+COPY ./src /app/src
+COPY README.md ./README.md
+COPY LICENSE LICENSE
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --frozen --no-dev --no-editable
+
+FROM python:3.12.16-slim-bookworm@sha256:935c3c5b12357a7e10caa9c1e6ca5692344d97cf229832ef584be2cec9fc03df
+
+WORKDIR /app
+ 
+COPY --from=uv --chown=app:app /app/.venv /app/.venv
+
+# Ensure executables in the venv take precedence over system executables
+ENV PATH="/app/.venv/bin:$PATH"
+
+# when running the container, add --db-path and a bind mount to the host's db file
+ENTRYPOINT ["mcp-server-docker"]