{"categories":[{"label":"Testing","url":"https://skillfed.io/packages/category/software-development-testing/6"}],"enrichment":{"capability":"A tox plugin that manages Docker container lifecycle during test runs, allowing you to spin up and configure containers (databases, services, etc.) as part of your test environment.","skillfed_tags":["docker-testing","tox-plugin","ci-cd"],"use_cases":["Integration tests requiring a live PostgreSQL or MySQL database without manual container management.","Testing microservices that depend on multiple containers (app server, cache, message queue) in a single tox run.","CI/CD pipelines where you want reproducible test environments without external service setup scripts.","Local development workflows where tox handles spinning up all test dependencies automatically.","Verifying application behavior against specific database versions by swapping container images in tox.ini."],"what_it_does":"tox-docker is a plugin for tox that automates the lifecycle of Docker containers during test execution. Instead of manually starting services before running tests, you declare containers in your tox.ini configuration\u2014specifying images, environment variables, port mappings, volumes, and health checks\u2014and the plugin handles spinning them up before tests run and tearing them down afterward.\n\nIt integrates seamlessly into tox's existing workflow: you configure containers with a [docker:container-name] section, reference them in your [testenv] via a docker directive, and the plugin exposes container ports and hostnames as environment variables for your tests to use. It supports multi-stage Dockerfiles, container linking, health checks, and parallel test runs with automatic container name suffixing to avoid port conflicts.","worth_installing":"Yes. If you use tox for testing and need Docker containers as part of your test environment, this plugin eliminates manual container orchestration. It's actively maintained, has no known vulnerabilities, carries a permissive license, and low install friction. Install it when your test suite depends on external services (databases, caches, APIs) that you want to manage declaratively."},"id":"tox-docker","links":{"html":"https://skillfed.io/packages/tox-docker","md":"https://skillfed.io/packages/tox-docker.md","pypi":"https://pypi.org/project/tox-docker/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2024-05-25","license_spdx":null,"license_treatment":"permissive","name":"tox-docker","python_support":"unspecified","summary":"Manage lifecycle of docker containers during Tox test runs"},"popularity":{"monthly_downloads":102767,"position":12849,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"5.0.0"}