compile-pdf-impose 0.1.0__tar.gz

compile_pdf_impose-0.1.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,48 @@
+name: publish-pypi
+
+# Publishes compile-pdf-impose to PyPI when a v*.*.* tag is pushed.
+#
+# Auth: PyPI Trusted Publishers (OIDC) — no API token in secrets.
+# Configure once at https://pypi.org/manage/account/publishing/ with:
+#   - PyPI project: compile-pdf-impose
+#   - Owner:        printwithsynergy
+#   - Repository:   compile-pdf-impose
+#   - Workflow:     publish-pypi.yml
+#   - Environment:  release
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  build:
+    name: build sdist + wheel
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install --upgrade pip build
+      - run: python -m build --sdist --wheel --outdir dist/
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*
+
+  publish:
+    name: publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: release
+      url: https://pypi.org/project/compile-pdf-impose/
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

compile_pdf_impose-0.1.0/PKG-INFO

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: compile-pdf-impose
+Version: 0.1.0
+Summary: CompilePDF impose producer.
+Project-URL: Homepage, https://compilepdf.com
+Project-URL: Repository, https://github.com/printwithsynergy/compile-pdf-impose
+Project-URL: Issues, https://github.com/printwithsynergy/compile-pdf-impose/issues
+Author-email: Print With Synergy <iam@quincy.codes>
+License: AGPL-3.0-or-later
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.12
+Requires-Dist: click>=8.1
+Requires-Dist: codex-pdf<2.0,>=1.15.0
+Requires-Dist: compile-pdf-core<1.0,>=0.1.0
+Requires-Dist: fastapi>=0.110
+Requires-Dist: pikepdf>=8.13
+Requires-Dist: pillow>=10.2
+Requires-Dist: pydantic>=2.6
+Requires-Dist: structlog>=24.1
+Provides-Extra: dev
+Requires-Dist: mypy>=1.9; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# compile-pdf-impose
+
+Sheet-level step-and-repeat layout for CompilePDF.
+
+Layout solved by `codex_pdf.geom.tile_grid`; this package drops cells via `pikepdf`. Configurable sheet, gutter, cell rotation, page mapping. Back-side modes: work-and-turn, work-and-tumble. Cell-extract round-trip verifier (Layer 5) confirms every cell matches its source page SHA-256.
+
+## Install
+
+```
+pip install compile-pdf-impose
+```
+
+## Position in the stack
+
+One of four [CompilePDF](https://compilepdf.com) producers (trap, impose, marks, rewrite). Each lives in its own repo and PyPI package so you install only what you need. Producers depend on `compile-pdf-core`, never on each other.
+
+- Repo: https://github.com/printwithsynergy/compile-pdf-impose
+- Deployment host: https://github.com/printwithsynergy/compile-pdf
+- License: AGPL-3.0-or-later

compile_pdf_impose-0.1.0/README.md

@@ -0,0 +1,19 @@
+# compile-pdf-impose
+
+Sheet-level step-and-repeat layout for CompilePDF.
+
+Layout solved by `codex_pdf.geom.tile_grid`; this package drops cells via `pikepdf`. Configurable sheet, gutter, cell rotation, page mapping. Back-side modes: work-and-turn, work-and-tumble. Cell-extract round-trip verifier (Layer 5) confirms every cell matches its source page SHA-256.
+
+## Install
+
+```
+pip install compile-pdf-impose
+```
+
+## Position in the stack
+
+One of four [CompilePDF](https://compilepdf.com) producers (trap, impose, marks, rewrite). Each lives in its own repo and PyPI package so you install only what you need. Producers depend on `compile-pdf-core`, never on each other.
+
+- Repo: https://github.com/printwithsynergy/compile-pdf-impose
+- Deployment host: https://github.com/printwithsynergy/compile-pdf
+- License: AGPL-3.0-or-later

compile_pdf_impose-0.1.0/pyproject.toml

@@ -0,0 +1,70 @@
+[project]
+name = "compile-pdf-impose"
+version = "0.1.0"
+description = "CompilePDF impose producer."
+readme = "README.md"
+license = { text = "AGPL-3.0-or-later" }
+authors = [{ name = "Print With Synergy", email = "iam@quincy.codes" }]
+requires-python = ">=3.12"
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Multimedia :: Graphics",
+  "Topic :: Software Development :: Libraries",
+]
+
+dependencies = [
+  "compile-pdf-core>=0.1.0,<1.0",
+  "codex-pdf>=1.15.0,<2.0",
+  "fastapi>=0.110",
+  "pikepdf>=8.13",
+  "pydantic>=2.6",
+  "click>=8.1",
+  "structlog>=24.1",
+  "Pillow>=10.2",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.0",
+  "pytest-asyncio>=0.23",
+  "pytest-cov>=4.1",
+  "ruff>=0.4",
+  "mypy>=1.9",
+]
+
+[project.scripts]
+compile-pdf-impose = "compile_pdf_impose.cli:main"
+
+[project.urls]
+Homepage = "https://compilepdf.com"
+Repository = "https://github.com/printwithsynergy/compile-pdf-impose"
+Issues = "https://github.com/printwithsynergy/compile-pdf-impose/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/compile_pdf_impose"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP", "B", "SIM", "C4", "RET"]
+ignore = ["E501"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+addopts = ["-ra", "--strict-markers", "--strict-config"]
+asyncio_mode = "auto"
+
+[tool.coverage.run]
+source = ["src/compile_pdf_impose"]
+branch = true

compile_pdf_impose-0.1.0/src/compile_pdf_impose/__init__.py

@@ -0,0 +1,28 @@
+"""Impose producer — sheet-level step-and-repeat layout.
+
+Per spec §4.1 — consumes ``codex_pdf.geom.tile_grid`` (with the
+GEOM_SCHEMA_VERSION 1.1.0 extension for ``cell_rotation``,
+``flip_per_row``, ``bleed_handling``, ``CellPlacement``) as the
+canonical layout primitive. No Compile-side layout math.
+
+Codex surface consumed:
+
+- :func:`codex_pdf.geom.tile_grid` — the canonical step-and-repeat solver.
+- :class:`codex_pdf.geom.TileGrid` — input shape.
+- :class:`codex_pdf.geom.TileResult` — output container.
+- :class:`codex_pdf.geom.CellPlacement` — per-cell anchor + transform.
+"""
+
+from __future__ import annotations
+
+from codex_pdf.geom import CellPlacement, TileGrid, TileResult, tile_grid
+
+from compile_pdf_core.version import IMPOSE_SCHEMA_VERSION
+
+__all__ = [
+    "CellPlacement",
+    "IMPOSE_SCHEMA_VERSION",
+    "TileGrid",
+    "TileResult",
+    "tile_grid",
+]

compile_pdf_impose-0.1.0/src/compile_pdf_impose/api.py

@@ -0,0 +1,159 @@
+"""FastAPI router for the impose producer.
+
+Mounts under ``/v1/impose`` from :mod:`compile_pdf.api.main`. Single
+endpoint today: ``POST /v1/impose/apply``.
+"""
+
+from __future__ import annotations
+
+import base64
+import hashlib
+
+import structlog
+from fastapi import APIRouter, HTTPException, Request, status
+from pydantic import BaseModel, Field
+
+from compile_pdf_core.cache import compute_cache_key, hash_canonical_plan
+from compile_pdf_impose.engine import ImposePlanError, apply_plan
+from compile_pdf_impose.layout_schema import ImposePlan
+from compile_pdf_impose.verify import verify_impose
+from compile_pdf_core.retention import (
+    parse_consent,
+    persist_if_opted_in,
+    resolve_tenant,
+)
+from compile_pdf_core.version import (
+    CODEX_DOCUMENT_SCHEMA_VERSION_PIN,
+    IMPOSE_SCHEMA_VERSION,
+    VERSION,
+)
+
+logger = structlog.get_logger(__name__)
+
+router = APIRouter()
+
+
+class ImposeApplyRequest(BaseModel):
+    """Request envelope: an inline base64-encoded PDF + a plan."""
+
+    model_config = {"extra": "forbid"}
+
+    input_pdf_b64: str = Field(min_length=1)
+    plan: ImposePlan
+
+
+class ImposeApplyResponse(BaseModel):
+    model_config = {"extra": "forbid"}
+
+    output_pdf_b64: str
+    pdf_sha256: str
+    input_sha256: str
+    plan_sha256: str
+    cache_key: str
+    cache_hit: bool = False
+    sheets_written: int
+    cells_per_sheet: int
+    input_pages: int
+    schema_version: str = IMPOSE_SCHEMA_VERSION
+    compile_version: str = VERSION
+
+
+@router.post("/apply", response_model=ImposeApplyResponse, status_code=status.HTTP_200_OK)
+async def impose_apply(payload: ImposeApplyRequest, request: Request) -> ImposeApplyResponse:
+    """Impose an inline base64-encoded PDF onto sheets per the plan."""
+    try:
+        input_bytes = base64.b64decode(payload.input_pdf_b64, validate=True)
+    except (ValueError, TypeError) as exc:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail=f"input_pdf_b64 is not valid base64: {exc}",
+        ) from exc
+
+    if not input_bytes:
+        raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="input is empty")
+
+    input_sha256 = hashlib.sha256(input_bytes).hexdigest()
+    plan_sha256 = hash_canonical_plan(payload.plan.model_dump(mode="json"))
+
+    try:
+        from codex_pdf.color import COLOR_SCHEMA_VERSION
+        from codex_pdf.geom import GEOM_SCHEMA_VERSION
+    except ImportError as exc:  # pragma: no cover — codex-pdf is a hard dep
+        raise HTTPException(
+            status_code=500, detail=f"codex-pdf surface unavailable: {exc}"
+        ) from exc
+
+    cache_key = compute_cache_key(
+        producer="impose",
+        input_sha256=input_sha256,
+        canonical_plan_sha256=plan_sha256,
+        codex_pdf_package_version=_resolve_codex_pdf_version(),
+        color_schema_version=COLOR_SCHEMA_VERSION,
+        geom_schema_version=GEOM_SCHEMA_VERSION,
+        codex_document_schema_version=CODEX_DOCUMENT_SCHEMA_VERSION_PIN,
+    )
+
+    logger.info(
+        "impose.apply.start",
+        input_sha256=input_sha256[:16],
+        plan_sha256=plan_sha256[:16],
+        cache_key=cache_key[:16],
+    )
+
+    try:
+        result = apply_plan(input_bytes, payload.plan)
+    except ImposePlanError as exc:
+        raise HTTPException(status_code=422, detail=f"plan rejected: {exc}") from exc
+
+    verify = verify_impose(
+        input_bytes=input_bytes,
+        output_bytes=result.output_bytes,
+        plan=payload.plan,
+        expected_sheets=result.sheets_written,
+        determinism_replay=False,
+    )
+    if not (verify.layer1_schema and verify.layer3_unchanged and verify.layer5_cell_extract):
+        logger.error("impose.apply.verify_failed", failures=verify.failures)
+        raise HTTPException(
+            status_code=500,
+            detail={"error": "verify failed", "failures": verify.failures},
+        )
+
+    consent = parse_consent(request)
+    response = ImposeApplyResponse(
+        output_pdf_b64=base64.b64encode(result.output_bytes).decode("ascii"),
+        pdf_sha256=result.pdf_sha256,
+        input_sha256=input_sha256,
+        plan_sha256=plan_sha256,
+        cache_key=cache_key,
+        cache_hit=False,
+        sheets_written=result.sheets_written,
+        cells_per_sheet=result.cells_per_sheet,
+        input_pages=result.input_pages,
+    )
+    retained = persist_if_opted_in(
+        consent=consent,
+        producer="impose",
+        tenant=resolve_tenant(request),
+        input_bytes=input_bytes,
+        output_bytes=result.output_bytes,
+        result=response.model_dump(mode="json"),
+        input_sha256=input_sha256,
+    )
+    logger.info(
+        "impose.apply.ok",
+        output_sha256=result.pdf_sha256[:16],
+        sheets_written=result.sheets_written,
+        consent=consent,
+        retained=retained,
+    )
+    return response
+
+
+def _resolve_codex_pdf_version() -> str:
+    """Read codex_pdf wheel version Compile was deployed against."""
+    try:
+        from codex_pdf import __version__ as codex_version
+    except ImportError:
+        return "unknown"
+    return str(codex_version)

compile_pdf_impose-0.1.0/src/compile_pdf_impose/cli.py

@@ -0,0 +1,89 @@
+"""Click subcommand registration for ``compile-pdf impose``."""
+
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+
+import click
+
+from compile_pdf_impose.engine import ImposePlanError, apply_plan
+from compile_pdf_impose.layout_schema import ImposePlan, impose_plan_json_schema
+from compile_pdf_impose.verify import verify_impose
+
+
+def register(group: click.Group) -> None:
+    """Attach the ``impose`` subcommand to the top-level CLI group."""
+
+    @group.command("impose", help="Impose a 1-up PDF onto sheets.")
+    @click.option(
+        "--layout",
+        "layout_path",
+        type=click.Path(exists=True, dir_okay=False, path_type=Path),
+        required=True,
+        help="JSON impose-plan document.",
+    )
+    @click.option(
+        "--verify/--no-verify",
+        default=True,
+        help="Run four-layer post-condition checks before writing output.",
+    )
+    @click.argument(
+        "input_path",
+        type=click.Path(exists=True, dir_okay=False, path_type=Path),
+    )
+    @click.argument(
+        "output_path",
+        type=click.Path(dir_okay=False, path_type=Path),
+    )
+    def impose_cmd(
+        layout_path: Path,
+        input_path: Path,
+        output_path: Path,
+        verify: bool,
+    ) -> None:
+        plan_dict = json.loads(layout_path.read_text(encoding="utf-8"))
+        try:
+            plan = ImposePlan.model_validate(plan_dict)
+        except Exception as exc:
+            click.echo(f"plan validation failed: {exc}", err=True)
+            sys.exit(3)
+
+        input_bytes = input_path.read_bytes()
+        try:
+            result = apply_plan(input_bytes, plan)
+        except ImposePlanError as exc:
+            click.echo(f"plan rejected: {exc}", err=True)
+            sys.exit(4)
+
+        if verify:
+            check = verify_impose(
+                input_bytes=input_bytes,
+                output_bytes=result.output_bytes,
+                plan=plan,
+                expected_sheets=result.sheets_written,
+            )
+            if not check.passed:
+                click.echo("verify failed:", err=True)
+                for failure in check.failures:
+                    click.echo(f"  - {failure}", err=True)
+                sys.exit(4)
+
+        output_path.write_bytes(result.output_bytes)
+        click.echo(
+            json.dumps(
+                {
+                    "sheets_written": result.sheets_written,
+                    "cells_per_sheet": result.cells_per_sheet,
+                    "input_pages": result.input_pages,
+                    "pdf_sha256": result.pdf_sha256,
+                    "output": str(output_path),
+                },
+                indent=2,
+            )
+        )
+
+    @group.command("impose-schema", hidden=True, help="Dump the impose-plan JSON Schema.")
+    def impose_schema_cmd() -> None:
+        click.echo(json.dumps(impose_plan_json_schema(), indent=2))