v0.0.1 (in development)
Warning
ComposeKit is still in active development (pre-1.0). The API and behavior may
change between releases, and not every Compose feature is supported yet.
Not recommended for production use.
First 0.0.1 release. A Docker Compose parsing & orchestration engine for Apple's container, focused on running local-dev dependency stacks.
Highlights
Two layers
ComposeKit— runtime-agnostic spec core (parse, interpolate, profiles, plan); Yams-only.ComposeKitContainer— maps the model ontocontainerand orchestrates it.
Spec coverage (parse + translate)
- Images, ports, environment/
env_file, named + bind volumes, networks, labels. depends_onwith conditions:service_started,service_healthy(healthcheck-gated),service_completed_successfully(run-to-completion gated).profilesactivation,configs/secretsprovisioning,extends+include(deep-merge), advancedbuildfields.- Popular run flags: ulimits, shm_size, tty/stdin_open, dns options, runtime, and more; unsupported-but-popular fields are decoded and warned.
Orchestration
up/down/ps/logs/exec/pull/stop/start/restart.
Tooling & docs
compose-validateCLI (parse /--plan/--profile).- Swift-DocC site: https://flaticols.github.io/ComposeKit/
- Interop CI: compose-spec JSON Schema validation +
docker compose configparity + nightly schema sync.
Not yet
Multi-file -f merge / auto compose.override.yaml, restart: policy enforcement, network aliases / volume driver options, and full field-specific merge rules.
Install
.package(url: "https://github.com/flaticols/ComposeKit.git", from: "0.0.1"),