pycomposefile
Structured deserialization of Docker Compose files.
Decision gist · record as of 2026-08-14
Yes, if you need to parse Docker Compose files in Python and don't require active maintenance. The permissive MIT license and low install friction make it straightforward to adopt. However, the aging maintenance status (no release in 381 days) means you should verify the package handles your compose file version and be prepared to fork or patch if bugs arise.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later.
- Low install friction with a single dependency (pyyaml).
- Maintenance is aging—last commit was 2025-08-13 but the package hasn't seen a release in 381 days, suggesting the project may not be actively developed despite the repository remaining open.
License · maintenance · safety
MIT (permissive) — MIT license permits use in proprietary and open-source projects with minimal restrictions, requiring only attribution.
last release 2025-07-29 (381 days) · last repo commit 2025-08-13 · 6 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 6,344,811 downloads/mo, #1,925 on PyPI
Alternatives
Verify before relying
pip install pycomposefile
import pycomposefile
compose_data = pycomposefile.parse('docker-compose.yml')- Whether the package handles all Docker Compose file versions and schema variations.
- API stability and whether breaking changes are expected in future releases.
- Whether the package is maintained or in maintenance-only mode despite the archived flag being false.
What it is and what it does
Pycomposefile is a Python library for reading and deserializing Docker Compose files into structured data. It takes a compose YAML file and converts it into Python objects you can inspect and manipulate programmatically, rather than parsing raw YAML yourself. The package depends only on pyyaml and requires Python 3.9 or later.
The library is intended for tools or scripts that need to inspect or process compose configurations without running Docker itself. It sits in the top 5000 PyPI packages by download volume, suggesting real-world use, but maintenance appears to have slowed—the last release was over a year ago despite recent repository activity.
Use it for
- Inspect Docker Compose configurations programmatically in CI/CD pipelines or deployment tools.
- Validate or transform compose files before deployment without executing Docker commands.
- Build tooling that reads service definitions, environment variables, or volume mappings from compose files.
- Generate documentation or reports from compose file structure and configuration.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to parse Docker Compose files in Python and don't require active maintenance.
The permissive MIT license and low install friction make it straightforward to adopt. However, the aging maintenance status (no release in 381 days) means you should verify the package handles your compose file version and be prepared to fork or patch if bugs arise.
Install
pycomposefile on PyPI
Before you install
Low install friction with a single dependency (pyyaml). Maintenance is aging—last commit was 2025-08-13 but the package hasn't seen a release in 381 days, suggesting the project may not be actively developed despite the repository remaining open.
Requires Python 3.9 or later.
License in practice
MIT license permits use in proprietary and open-source projects with minimal restrictions, requiring only attribution.
Quickstart
pip install pycomposefile
import pycomposefile
compose_data = pycomposefile.parse('docker-compose.yml')Verify before relying
- Whether the package handles all Docker Compose file versions and schema variations.
- API stability and whether breaking changes are expected in future releases.
- Whether the package is maintained or in maintenance-only mode despite the archived flag being false.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagepyyaml |
| Maintenance | Aging 381 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 6,344,811 / month, #1,925 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: pycomposefile-0.0.34-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “docker compose file parser”
- pycomposefileParses and deserializes Docker Compose files into structured Python…
- docker-composeDocker Compose is a command-line tool for defining and running…
- pytest-dockerpytest-docker provides pytest fixtures that automatically spin up and…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also docker-compose · podman-compose · PyYAML · yamlable · poyo · py-serializable · pytest-docker · ovos-config · rosdistro · python-evtx