{"categories":[{"label":"Build Tools","url":"https://skillfed.io/packages/category/software-development-build-tools"}],"enrichment":{"capability":"A Python Docker client that wraps the Docker CLI with an intuitive, Pythonic API for container, image, and compose operations on Linux, macOS, and Windows.","skillfed_tags":["docker-automation","container-orchestration","devops-tooling"],"use_cases":["Automate container lifecycle in Python test suites by spinning up, configuring, and tearing down containers programmatically.","Build and push Docker images from Python scripts without subprocess calls or shell escaping.","Orchestrate multi-container applications using Docker Compose from Python code.","Copy files between host and containers, manage volumes, and inspect running containers in deployment automation.","Integrate GPU-enabled containers into Python applications with native parameter passing."],"what_it_does":"python-on-whales is a Python wrapper around the Docker CLI that translates Docker commands into intuitive Python method calls. Instead of shelling out to docker run or docker build, you call methods directly from Python code like run(), build(), pull(), and compose operations. It handles container lifecycle management, image operations, volume creation, networking, and Docker Compose orchestration.\n\nThe package is designed as a thin, direct mapping of Docker CLI operations to Python, so developers familiar with Docker commands can immediately recognize the equivalent Python calls. It depends on pydantic and typing-extensions for data validation and type hints, and requires Docker or Podman to be installed separately on the host system. The API returns Python objects that can be used as context managers to ensure cleanup, making it suitable for automation scripts, testing frameworks, and CI/CD pipelines.","worth_installing":"Yes. The package has low install friction, active maintenance, no known vulnerabilities, and a permissive MIT License. It solves a real problem\u2014making Docker operations accessible and type-safe from Python\u2014and is well-positioned for automation, testing, and CI/CD use cases. Install it if you need to orchestrate Docker from Python code."},"id":"python-on-whales","links":{"html":"https://skillfed.io/packages/python-on-whales","md":"https://skillfed.io/packages/python-on-whales.md","pypi":"https://pypi.org/project/python-on-whales/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-03-09","license_spdx":null,"license_treatment":"permissive","name":"python-on-whales","python_support":"supports_current","summary":"A Docker client for Python, designed to be fun and intuitive!"},"popularity":{"monthly_downloads":12831777,"position":1303,"tier":"top_5000"},"security":{"n_vulnerabilities":0},"version":"0.81.0"}