Port the compose-to-podman-pod converter into compose2pod#1
Merged
Conversation
Adds parsing module that validates compose documents against the supported subset, including a non-dict guard that raises UnsupportedComposeError for non-mapping inputs.
Add compose2pod.cli (main, POD_NAME_PATTERN, JSON/YAML auto-detect via --format), the python -m compose2pod entrypoint, and populate the package __init__ with the public API (validate, emit_script, EmitOptions, UnsupportedComposeError). Omit the trivial __main__.py shim from coverage (it is exercised only via subprocess in tests, which the parent coverage process can't measure); this keeps the enforced gate at 100% line coverage without enabling branch measurement.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Extracts the CI-proven compose-to-podman-pod converter (from the chats service prototype) into
compose2pod, a standalone, dependency-free public package.What it does
Converts a Docker Compose document into a POSIX
shscript that runs the services as a single Podman pod — for CI/test environments wheredocker composeandpodman kube playcan't run: unprivileged runners with a read-only/proc/sys(netavark can't create bridge networks) and no systemd (podman healthchecks aren't scheduled). A single pod shares one netns (no bridge, no netavark), services talk over127.0.0.1via--add-host, and startup is health-gated by pollingpodman healthcheck run. The core is stdlib-only so it installs and runs in minimal images; YAML input is an optional[yaml]extra.Supported compose subset
image/build,command,environment/env_file, short-form bindvolumes,healthcheck(CMD/CMD-SHELL),depends_on(all conditions), networkaliases. Anything outside the subset raises a clearUnsupportedComposeError;ports/restart/stdin_open/ttyare ignored with a warning.Included review fixes vs the prototype
validate(anull/scalar document raises cleanly instead of anAttributeError).start_period/retriesare now passed through topodman runas--health-start-period/--health-retries; the health-wait budget stays fixed (deliberately not shortened toretries × interval, which would break a longstart_period)._CMD_MIN_LENGTH.emit_script's target branch into_emit_target.Quality
__main__.pyomitted from coverage.ruff select=ALL/ty/eof-fixerclean. Python 3.10–3.14 matrix.uv_build,justrecipes, tag-driven PyPI Trusted Publishing — mirrors the modern-di conventions.docs/superpowers/plans/2026-07-03-compose2pod-extraction.md.Follow-ups (not in this PR)
trap's nested quoting for the library API path (emit_scriptwith an arbitrary pod name); it's unreachable via the CLI, which validates pod names. Deserves its own change with a library-API test.compose2pod, workflowrelease.yml, environmentpypi).