docker-compose-py

A Python wrapper to provide a pip-installable Docker Compose CLI (docker-compose) binary.

Installation

pip install docker-compose-py

Or install a platform wheel directly from a GitHub Release (for air-gapped/offline use):

pip install https://github.com/neeve-ai/docker-compose-py/releases/download/v5.6.0.0/docker_compose_py-5.6.0.0-py2.py3-none-manylinux_2_17_x86_64.whl

Usage

After installation, the docker-compose binary is available in your environment:

docker-compose version
docker-compose config --quiet

As a pre-commit hook

Add to your .pre-commit-config.yaml:

- repo: https://github.com/neeve-ai/docker-compose-py
  rev: v5.6.0.0
  hooks:
  - id: docker-compose

This runs docker-compose config --quiet to validate the default compose file (compose.yml or docker-compose.yml in the current directory).

To validate a non-default file:

- repo: https://github.com/neeve-ai/docker-compose-py
  rev: v5.6.0.0
  hooks:
  - id: docker-compose
    args: [-f, path/to/docker-compose.yml, config, --quiet]

Supported Platforms

Note: Only the two mainstream Linux architectures (x86_64 and aarch64) are supported, as PyPI does not support exotic Linux wheel tags (armv6l, armv7l, ppc64le, riscv64, s390x) in its registry. Windows x86 (32-bit) and Linux i686 are also unsupported.

Updating to a new Docker Compose version

./update_version.sh 5.4.0

This downloads the checksums.txt from the new release and regenerates setup.cfg with updated URLs and SHA-256 hashes for all 6 supported platforms.