Docker Composer

A library to interact with docker-compose V2 from a python Program. All commands and parameters are exposed as python classes and attributes to allow for full auto-completion of its parameters with IDEs that support it.

Runtime footprint: This library is stdlib-only (zero third-party runtime dependencies).

Install

pip install docker-composer

Usage

The main class is docker_composer.DockerCompose. Its parameters are all options from docker-compose.

Each docker-compose command has a corresponding function, e.g. DockerCompose.run or DockerCompose.scale. Their arguments again mirror the options of the corresponding command.

The resulting object has a call function. It takes arbitrary strings as input, as well as all keyword arguments from subprocess.run, and returns a subprocess.CompletedProcess

from docker_composer import DockerCompose


base = DockerCompose(file="docker-compose.yml", verbose=True)
base.run(detach=True, workdir="/tmp").call("app")
base.run(workdir="/tmp").call("app", "/bin/bash", "-l")

# /tmp $ ls /.dockerenv
# /.dockerenv
# /tmp $ exit

process = base.ps(all=True).call(capture_output=True)
print(process.stdout.encode("UTF-8"))
#          Name                      Command           State    Ports
# -------------------------------------------------------------------
# myapp_app_70fd8b786b76   myapp --start-server        Exit 0        
# myapp_app_6ac3db4e1b55   myapp --client              Exit 0

Develop

Development Setup

When developing, the _utils module is available for generating the docker_composer module from the docker composeCLI help output. This is not required for normal package usage.

uv sync --group dev
uv run poe generate

Coding Standards

Type	Package	Comment
Linter	`ruff`	Also for auto-formatted modules
Logging	`logging`
Packaging	`uv`
Tests	`pytest`
Typing	`mypy`	Type all methods
Imports	`ruff`

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

docker_composer-5.3.0.tar.gz (26.6 kB view details)

Uploaded Jul 14, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

docker_composer-5.3.0-py3-none-any.whl (41.5 kB view details)

Uploaded Jul 14, 2026 Python 3

File details

Details for the file docker_composer-5.3.0.tar.gz.

File metadata

Download URL: docker_composer-5.3.0.tar.gz
Upload date: Jul 14, 2026
Size: 26.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for docker_composer-5.3.0.tar.gz
Algorithm	Hash digest
SHA256	`6672909808d5bffd82c48af699d7abda76bc97f072cae4e8c94befd5d67c3446`
MD5	`ff71c17b3187e27796e4ca8d3d626ee2`
BLAKE2b-256	`d2845d8a908cad85b6532848b149a687068336a8a5fe45bf8835bd9c8c3ccc89`

See more details on using hashes here.

Provenance

The following attestation bundles were made for docker_composer-5.3.0.tar.gz:

Publisher: python.yml on schollm/docker-composer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: docker_composer-5.3.0.tar.gz
- Subject digest: 6672909808d5bffd82c48af699d7abda76bc97f072cae4e8c94befd5d67c3446
- Sigstore transparency entry: 2167066297
- Sigstore integration time: Jul 14, 2026
Source repository:
- Permalink: schollm/docker-composer@36fa5800f6b38b4649bb1365402be2bff18ec077
- Branch / Tag: refs/tags/v5.3.0
- Owner: https://github.com/schollm
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python.yml@36fa5800f6b38b4649bb1365402be2bff18ec077
- Trigger Event: push