docker-orb 1.0.0__tar.gz → 1.0.1__tar.gz

docker_orb-1.0.1/.github/workflows/publish.yml

@@ -0,0 +1,78 @@
+name: Publish to PyPI
+
+# Runs the test suite on every push/PR to main; only builds and publishes
+# to PyPI when a GitHub Release is published (or manually via
+# workflow_dispatch, for re-running a failed publish without cutting a new
+# release). Publishing uses PyPI's Trusted Publishing (OIDC) — no API token
+# stored anywhere here.
+#
+# ⚠ ONE-TIME SETUP STILL NEEDED (see CLAUDE.md "Release process"): register
+# this workflow as a trusted publisher on the PyPI project page
+# (pypi.org/manage/project/docker-orb/settings/publishing/) with owner
+# "adlidev", repo "docker-orb", workflow filename "publish.yml", and
+# Environment name left BLANK (no GitHub environment gate is configured
+# here). Publishing will fail with an auth error until that's done.
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install
+        run: python -m pip install -e . --group dev
+
+      - name: Run tests
+        run: pytest -q
+
+  publish:
+    name: Build and publish to PyPI
+    needs: test
+    if: github.event_name == 'release' || github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write   # required for PyPI Trusted Publishing (OIDC)
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+
+      - name: Check package metadata
+        run: |
+          python -m pip install --upgrade twine
+          python -m twine check dist/*
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          # Safety net for re-running this job (workflow_dispatch, or a
+          # retried run) after a version already made it to PyPI — skips
+          # re-upload instead of failing, rather than actually enabling
+          # re-publishing the same version's files.
+          skip-existing: true

{docker_orb-1.0.0 → docker_orb-1.0.1}/CLAUDE.md

@@ -74,6 +74,30 @@ them depended on anything Kubernetes-specific), just wired up with
 works fine, of course, to point docker-orb at any other real
 `docker-compose.yml` project you have running.
 
+## Release process
+
+`.github/workflows/publish.yml` tests on 3.10/3.11/3.12 on every push/PR to
+`main`, and builds + publishes to PyPI whenever a GitHub Release is
+published, via PyPI Trusted Publishing (OIDC) — no stored token.
+
+**⚠ TODO, still pending:** register this workflow as a trusted publisher on
+PyPI before the first automated publish will work — pypi.org → docker-orb
+project → Manage → Publishing → "Add a new publisher":
+- Owner: `adlidev`
+- Repository name: `docker-orb`
+- Workflow filename: `publish.yml`
+- Environment name: leave **blank** (no GitHub environment gate is
+  configured in the workflow — that step was intentionally skipped for
+  now; add `environment: pypi` back in publish.yml plus a matching
+  environment under repo Settings → Environments if a manual-approval gate
+  is wanted later).
+
+Until that's done, a release will run the build/check steps fine but fail
+on the actual `pypi-publish` upload step with an auth error.
+
+Going forward, a release is: bump `version` in `pyproject.toml` → commit →
+tag and publish a GitHub Release → the workflow does the rest.
+
 ## Architecture
 
 docker-orb is a **Textual TUI** app with two entry points:

{docker_orb-1.0.0 → docker_orb-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docker-orb
-Version: 1.0.0
+Version: 1.0.1
 Summary: Interactive terminal UI for streaming and filtering Docker Compose container logs across multiple services
 Project-URL: Homepage, https://github.com/adlidev/docker-orb
 Project-URL: Repository, https://github.com/adlidev/docker-orb
@@ -105,14 +105,11 @@ Requires Python 3.10+, and `docker` with the Compose v2 plugin on your
 Docker SDK involved.
 
 ```bash
-# Recommended — pipx keeps CLI tools in isolated environments. Not on PyPI
-# yet, so install straight from GitHub:
-pipx install git+https://github.com/adlidev/docker-orb
+# Recommended — pipx keeps CLI tools in isolated environments
+pipx install docker-orb
 
-# Or with plain pip, inside your own venv:
-git clone https://github.com/adlidev/docker-orb.git
-cd docker-orb
-pip install -e .
+# Or with plain pip
+pip install docker-orb
 ```
 
 This installs two commands: `docker-orb` and `docker-orb-inject` (a small

{docker_orb-1.0.0 → docker_orb-1.0.1}/README.md

@@ -52,14 +52,11 @@ Requires Python 3.10+, and `docker` with the Compose v2 plugin on your
 Docker SDK involved.
 
 ```bash
-# Recommended — pipx keeps CLI tools in isolated environments. Not on PyPI
-# yet, so install straight from GitHub:
-pipx install git+https://github.com/adlidev/docker-orb
+# Recommended — pipx keeps CLI tools in isolated environments
+pipx install docker-orb
 
-# Or with plain pip, inside your own venv:
-git clone https://github.com/adlidev/docker-orb.git
-cd docker-orb
-pip install -e .
+# Or with plain pip
+pip install docker-orb
 ```
 
 This installs two commands: `docker-orb` and `docker-orb-inject` (a small

{docker_orb-1.0.0 → docker_orb-1.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "docker-orb"
-version = "1.0.0"
+version = "1.0.1"
 description = "Interactive terminal UI for streaming and filtering Docker Compose container logs across multiple services"
 readme = "README.md"
 requires-python = ">=3.10"