pubkit 0.1.0__tar.gz → 0.1.1__tar.gz

{pubkit-0.1.0 → pubkit-0.1.1}/CHANGELOG.md

@@ -4,6 +4,23 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 Versioning is [semantic](https://semver.org/); adapters may change behaviour on
 a minor bump when a platform changes underneath them.
 
+## [0.1.1] — 2026-09-11
+
+### Added
+
+- Docker image on the Playwright base (`ghcr.io/arunsingh/pubkit`), so browser
+  adapters work in CI without hand-installing Chromium's system libraries.
+- `action.yml` — the repository is now a reusable GitHub Action.
+- `CITATION.cff`, and a Homebrew formula template under `packaging/`.
+
+### Fixed
+
+- `pubkit doctor` ignored `PLAYWRIGHT_BROWSERS_PATH` and reported Chromium as
+  missing on managed images (CI runners, devcontainers, the Playwright Docker
+  image) where it was in fact installed — sending people off to fix a problem
+  they did not have. Found by running the published package in exactly such an
+  environment.
+
 ## [0.1.0] — 2026-09-11
 
 First release. Extracted from a real, painful publishing run: a 15,000-word

{pubkit-0.1.0 → pubkit-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pubkit
-Version: 0.1.0
+Version: 0.1.1
 Summary: Publish one source to many platforms, safely. Medium, Substack, X, Dev.to, Hashnode.
 Project-URL: Homepage, https://github.com/arunsingh/pubkit
 Project-URL: Issues, https://github.com/arunsingh/pubkit/issues
@@ -229,6 +229,28 @@ ghost = "my_pubkit_ghost:GhostAdapter"
 Five extension points, all first-class: `pubkit.adapters`, `pubkit.renderers`,
 `pubkit.checks`, `pubkit.hooks`, and per-platform `transforms:` in config.
 
+## Install it however you like
+
+```bash
+pip install "pubkit[all]"                       # the normal way
+pipx install "pubkit[all]"                      # isolated CLI
+uv tool install "pubkit[all]"                   # same, faster
+docker run --rm -v "$PWD:/work" ghcr.io/arunsingh/pubkit validate content/
+```
+
+The Docker image ships Chromium and its system libraries, which is the part
+nobody wants to install on a CI runner by hand.
+
+As a GitHub Action, no install step at all:
+
+```yaml
+- uses: arunsingh/pubkit@v1
+  with:
+    command: plan
+    path: content/
+    platforms: medium,devto
+```
+
 ## Fit it into a workflow
 
 **GitHub Actions** — plan on every PR, publish on merge:

{pubkit-0.1.0 → pubkit-0.1.1}/README.md

@@ -179,6 +179,28 @@ ghost = "my_pubkit_ghost:GhostAdapter"
 Five extension points, all first-class: `pubkit.adapters`, `pubkit.renderers`,
 `pubkit.checks`, `pubkit.hooks`, and per-platform `transforms:` in config.
 
+## Install it however you like
+
+```bash
+pip install "pubkit[all]"                       # the normal way
+pipx install "pubkit[all]"                      # isolated CLI
+uv tool install "pubkit[all]"                   # same, faster
+docker run --rm -v "$PWD:/work" ghcr.io/arunsingh/pubkit validate content/
+```
+
+The Docker image ships Chromium and its system libraries, which is the part
+nobody wants to install on a CI runner by hand.
+
+As a GitHub Action, no install step at all:
+
+```yaml
+- uses: arunsingh/pubkit@v1
+  with:
+    command: plan
+    path: content/
+    platforms: medium,devto
+```
+
 ## Fit it into a workflow
 
 **GitHub Actions** — plan on every PR, publish on merge:

{pubkit-0.1.0 → pubkit-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pubkit"
-version = "0.1.0"
+version = "0.1.1"
 description = "Publish one source to many platforms, safely. Medium, Substack, X, Dev.to, Hashnode."
 readme = "README.md"
 requires-python = ">=3.11"

{pubkit-0.1.0 → pubkit-0.1.1}/src/pubkit/__init__.py

@@ -6,7 +6,7 @@ from .core.loader import load_document, load_series  # noqa: F401
 from .core.runner import Pipeline, RunReport  # noqa: F401
 from .registry import build_adapter, list_adapters, register  # noqa: F401
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"
 __all__ = [
     "Document", "Series", "Asset", "Figure", "Table", "Heading", "Paragraph", "Code",
     "Pipeline", "RunReport", "load_document", "load_series",

{pubkit-0.1.0 → pubkit-0.1.1}/src/pubkit/scaffold.py

@@ -212,14 +212,34 @@ def diagnose() -> list[Finding]:
     )
 
     if _has("playwright"):
-        from pathlib import Path as _P
-
-        cache = _P.home() / (
-            "Library/Caches/ms-playwright" if platform.system() == "Darwin" else ".cache/ms-playwright"
-        )
-        found = cache.exists() and any(cache.glob("chromium*"))
+        # Honour PLAYWRIGHT_BROWSERS_PATH. Managed images (CI runners, devcontainers,
+        # the Playwright Docker image) put browsers somewhere else entirely, and
+        # reporting "not downloaded" when they are right there sends people off to
+        # fix a problem they do not have.
+        override = os.environ.get("PLAYWRIGHT_BROWSERS_PATH")
+        if override and override != "0":
+            roots = [Path(override)]
+            where = override
+        else:
+            roots = [
+                Path.home()
+                / (
+                    "Library/Caches/ms-playwright"
+                    if platform.system() == "Darwin"
+                    else "AppData/Local/ms-playwright"
+                    if platform.system() == "Windows"
+                    else ".cache/ms-playwright"
+                )
+            ]
+            where = "the default cache"
+        found = [d for r in roots if r.exists() for d in r.glob("chromium*")]
         out.append(
-            Finding(found, "chromium", "downloaded" if found else "not downloaded", "playwright install chromium")
+            Finding(
+                bool(found),
+                "chromium",
+                f"{len(found)} build(s) in {where}" if found else f"none in {where}",
+                "playwright install chromium",
+            )
         )
 
     out.append(

{pubkit-0.1.0 → pubkit-0.1.1}/tests/test_core.py

@@ -421,3 +421,19 @@ async def test_transient_errors_are_retried():
 
     assert await with_retry(fn, attempts=4, base=0.001) == "ok"
     assert calls == 3
+
+
+def test_doctor_honours_playwright_browsers_path(tmp_path, monkeypatch):
+    """Managed images put browsers outside the default cache.
+
+    Reporting "not downloaded" when Chromium is sitting right there sends
+    someone off to fix a problem they do not have.
+    """
+    from pubkit.scaffold import diagnose
+
+    (tmp_path / "chromium-1194").mkdir()
+    monkeypatch.setenv("PLAYWRIGHT_BROWSERS_PATH", str(tmp_path))
+    findings = {f.label: f for f in diagnose()}
+    if "chromium" in findings:                  # only present when playwright is installed
+        assert findings["chromium"].ok
+        assert str(tmp_path) in findings["chromium"].detail