ptctools 0.2.1__tar.gz → 0.2.2__tar.gz

ptctools-0.2.2/.github/workflows/release.yml

@@ -0,0 +1,139 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: New stable version, for example 0.2.2
+        required: true
+        type: string
+
+permissions:
+  contents: write
+  id-token: write
+
+concurrency:
+  group: release
+  cancel-in-progress: false
+
+jobs:
+  release:
+    name: Release v${{ inputs.version }}
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+
+    steps:
+      - name: Check out main
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+          ref: main
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          enable-cache: true
+
+      - name: Validate release version
+        env:
+          RELEASE_VERSION: ${{ inputs.version }}
+        run: |
+          set -euo pipefail
+
+          python3 - <<'PY'
+          import os
+          import re
+          import tomllib
+          from pathlib import Path
+
+          version = os.environ["RELEASE_VERSION"]
+          if not re.fullmatch(
+              r"(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)",
+              version,
+          ):
+              raise SystemExit("version must use the stable X.Y.Z format")
+
+          with Path("pyproject.toml").open("rb") as handle:
+              current = tomllib.load(handle)["project"]["version"]
+
+          parse = lambda value: tuple(int(part) for part in value.split("."))
+          if parse(version) <= parse(current):
+              raise SystemExit(
+                  f"release version {version} must be greater than current version {current}"
+              )
+
+          env_file = Path(os.environ["GITHUB_ENV"])
+          with env_file.open("a") as handle:
+              handle.write(f"VERSION={version}\n")
+              handle.write(f"TAG=v{version}\n")
+          PY
+
+          git fetch --tags --force origin
+          if git rev-parse --verify --quiet "refs/tags/v${RELEASE_VERSION}"; then
+            echo "tag v${RELEASE_VERSION} already exists" >&2
+            exit 1
+          fi
+
+      - name: Update package version
+        run: |
+          set -euo pipefail
+
+          uv version "$VERSION" --no-sync
+          python3 - <<'PY'
+          import os
+          import re
+          from pathlib import Path
+
+          path = Path("src/ptctools/__init__.py")
+          content = path.read_text()
+          updated, count = re.subn(
+              r'^__version__ = "[^"]+"$',
+              f'__version__ = "{os.environ["VERSION"]}"',
+              content,
+              count=1,
+              flags=re.MULTILINE,
+          )
+          if count != 1:
+              raise SystemExit("could not update exactly one __version__ assignment")
+          path.write_text(updated)
+          PY
+          uv lock
+
+      - name: Run tests
+        run: uv run --extra dev --locked pytest -q tests
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Check distributions
+        run: uvx --from twine twine check dist/*
+
+      - name: Commit and tag release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -euo pipefail
+
+          gh auth setup-git --hostname github.com
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add pyproject.toml uv.lock src/ptctools/__init__.py
+          git commit -m "chore(release): $TAG"
+          git tag -a "$TAG" -m "Release $TAG"
+          git push --atomic origin HEAD:main "$TAG"
+
+      - name: Create GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -euo pipefail
+
+          gh release create "$TAG" dist/* \
+            --title "$TAG" \
+            --generate-notes \
+            --verify-tag
+
+      - name: Publish distributions to PyPI
+        run: uv publish --trusted-publishing always

{ptctools-0.2.1 → ptctools-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: ptctools
-Version: 0.2.1
+Version: 0.2.2
 Summary: Portainer Client Tools - CLI for managing Portainer from client
 License-File: LICENSE
 Requires-Python: >=3.10
@@ -168,3 +168,23 @@ Remove all exited containers and unused (dangling) images. Use `-y` to skip conf
 
 ### `ptctools utils backup/restore`
 Local backup/restore operations using Duplicati CLI (docker or local). Does not require Portainer.
+
+## Releasing
+
+The `Release` GitHub Actions workflow creates a new stable release from `main`.
+Run it from the Actions tab and provide a canonical version in `X.Y.Z` format
+(without leading zeroes), such as `0.2.2`. The workflow:
+
+1. Requires the requested version to be greater than the current package version.
+2. Updates `pyproject.toml`, `uv.lock`, and `src/ptctools/__init__.py`.
+3. Runs the test suite and builds the wheel and source distribution.
+4. Commits the version change to `main` and creates an annotated `vX.Y.Z` tag.
+5. Creates a GitHub Release with generated notes and both distribution files.
+6. Publishes the same distribution files to PyPI through Trusted Publishing.
+
+The workflow uses the repository `GITHUB_TOKEN` for GitHub and an ephemeral OIDC
+token for PyPI; no additional release secret is required. The PyPI Trusted
+Publisher must authorize repository `tamntlib/ptctools` and workflow
+`release.yml`, with environment `pypi`. A failed test, invalid version, existing
+tag, or distribution check stops the release before the commit and tag are
+pushed.

{ptctools-0.2.1 → ptctools-0.2.2}/README.md

@@ -154,3 +154,23 @@ Remove all exited containers and unused (dangling) images. Use `-y` to skip conf
 
 ### `ptctools utils backup/restore`
 Local backup/restore operations using Duplicati CLI (docker or local). Does not require Portainer.
+
+## Releasing
+
+The `Release` GitHub Actions workflow creates a new stable release from `main`.
+Run it from the Actions tab and provide a canonical version in `X.Y.Z` format
+(without leading zeroes), such as `0.2.2`. The workflow:
+
+1. Requires the requested version to be greater than the current package version.
+2. Updates `pyproject.toml`, `uv.lock`, and `src/ptctools/__init__.py`.
+3. Runs the test suite and builds the wheel and source distribution.
+4. Commits the version change to `main` and creates an annotated `vX.Y.Z` tag.
+5. Creates a GitHub Release with generated notes and both distribution files.
+6. Publishes the same distribution files to PyPI through Trusted Publishing.
+
+The workflow uses the repository `GITHUB_TOKEN` for GitHub and an ephemeral OIDC
+token for PyPI; no additional release secret is required. The PyPI Trusted
+Publisher must authorize repository `tamntlib/ptctools` and workflow
+`release.yml`, with environment `pypi`. A failed test, invalid version, existing
+tag, or distribution check stops the release before the commit and tag are
+pushed.

{ptctools-0.2.1 → ptctools-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ptctools"
-version = "0.2.1"
+version = "0.2.2"
 description = "Portainer Client Tools - CLI for managing Portainer from client"
 readme = "README.md"
 requires-python = ">=3.10"

{ptctools-0.2.1 → ptctools-0.2.2}/src/ptctools/__init__.py

@@ -1,6 +1,6 @@
 """Portainer Client Tools - CLI for managing Portainer stacks and backups."""
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"
 
 import sys
 import os

{ptctools-0.2.1 → ptctools-0.2.2}/src/ptctools/_portainer.py

@@ -109,8 +109,10 @@ def get_portainer_docker_client(
     api_client.mount("http://", adapter)
     api_client.mount("https://", adapter)
 
-    # Wrap in high-level client
-    client = docker.DockerClient()
+    # DockerClient.__init__ creates another APIClient and probes the local
+    # Docker daemon. Build only the high-level wrapper and attach the
+    # Portainer-proxied API client directly.
+    client = docker.DockerClient.__new__(docker.DockerClient)
     client.api = api_client
 
     return client

ptctools-0.2.2/tests/test_portainer.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+import docker
+
+from ptctools._portainer import get_portainer_docker_client
+
+
+def test_get_portainer_docker_client_does_not_initialize_local_client(
+    monkeypatch,
+) -> None:
+    constructor_calls = 0
+
+    def fail_if_initialized(self, *args, **kwargs) -> None:
+        nonlocal constructor_calls
+        constructor_calls += 1
+        raise AssertionError("DockerClient constructor must not probe a local daemon")
+
+    monkeypatch.setattr(docker.DockerClient, "__init__", fail_if_initialized)
+
+    client = get_portainer_docker_client(
+        "https://portainer.example.com",
+        "test-token",
+        7,
+    )
+
+    try:
+        assert constructor_calls == 0
+        assert isinstance(client, docker.DockerClient)
+        assert client.api.base_url == "http://localhost:2375"
+    finally:
+        client.close()

{ptctools-0.2.1 → ptctools-0.2.2}/uv.lock

@@ -149,7 +149,7 @@ name = "exceptiongroup"
 version = "1.3.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
 wheels = [
@@ -194,7 +194,7 @@ wheels = [
 
 [[package]]
 name = "ptctools"
-version = "0.2.1"
+version = "0.2.2"
 source = { editable = "." }
 dependencies = [
     { name = "click" },