{"id":36883701,"url":"https://github.com/31z4/tox-docker","last_synced_at":"2026-01-12T15:27:45.721Z","repository":{"id":69811894,"uuid":"591956396","full_name":"31z4/tox-docker","owner":"31z4","description":"Multi-arch Docker image packaging for tox. Includes common build dependencies and currently active CPython versions.","archived":false,"fork":false,"pushed_at":"2024-11-15T09:36:19.000Z","size":87,"stargazers_count":7,"open_issues_count":2,"forks_count":3,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-11-15T10:31:55.361Z","etag":null,"topics":["docker","python","testing","tox"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/31z4/tox","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/31z4.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-01-22T13:32:14.000Z","updated_at":"2024-11-15T09:25:41.000Z","dependencies_parsed_at":"2024-11-15T10:25:10.079Z","dependency_job_id":null,"html_url":"https://github.com/31z4/tox-docker","commit_stats":null,"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/31z4/tox-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/31z4%2Ftox-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/31z4%2Ftox-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/31z4%2Ftox-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/31z4%2Ftox-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/31z4","download_url":"https://codeload.github.com/31z4/tox-docker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/31z4%2Ftox-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28340746,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T12:22:26.515Z","status":"ssl_error","status_checked_at":"2026-01-12T12:22:10.856Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","python","testing","tox"],"created_at":"2026-01-12T15:27:45.643Z","updated_at":"2026-01-12T15:27:45.698Z","avatar_url":"https://github.com/31z4.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docker image packaging for tox\n\n[tox](https://tox.wiki) is a generic Python virtual environment management and test command line tool.\nThis multi-arch Docker image neatly packages tox v4 along with common build dependencies (e.g., `make`, `gcc`, etc) and currently [active CPython versions](https://devguide.python.org/versions/#status-of-python-versions):\n* 3.9\n* 3.10\n* 3.11\n* 3.12\n* 3.13\n\nThe image is secure, tested, compact, and easy to use.\nAt this moment, it supports the following platforms:\n* `linux/arm64/v8`\n* `linux/amd64`\n\nThe following demo shows how to test [Flask](https://github.com/pallets/flask) using out-of-the box Docker image for tox:\n\n![tox copy](https://user-images.githubusercontent.com/3657959/217558483-db24bc8e-c0f1-4591-9be0-1a19d1d48c7d.gif)\n\nYou can try it yourself by running the following commands:\n\n```\n$ git clone --depth 1 --branch 3.0.0 https://github.com/pallets/flask.git\n$ docker run -v `pwd`/flask:/tests -it --rm 31z4/tox run-parallel --skip-env style\n```\n\n## Usage\n\nThe recommended way of using the image is to mount the directory that contains your tox configuration files and your code as a volume.\nAssuming your project is within the current directory of the host, use the following command to run `tox` without any flags:\n\n\t$ docker run -v `pwd`:/tests -it --rm 31z4/tox\n\nAlso, you can easily pass subcommands and flags:\n\n\t$ docker run -v `pwd`:/tests -it --rm 31z4/tox run-parallel -e black,py312\n\nNote, that the image is configured with a working directory at `/tests`.\n\nIf you want to install additional Python versions/implementations or Ubuntu packages you can create a derivative image.\nJust make sure you switch the user to `root` when needed and switch back to `tox` afterwards:\n\n```Dockerfile\nFROM 31z4/tox\n\nUSER root\n\nRUN set -eux; \\\n    apt-get update; \\\n    DEBIAN_FRONTEND=noninteractive \\\n    apt-get install -y --no-install-recommends \\\n        python3.7; \\\n    rm -rf /var/lib/apt/lists/*\n\nUSER tox\n```\n\n## Versioning\n\nImage tags have the form of `{tox-version}-{image-version}` where `image-version` part is optional and follows [semantic versioning](https://semver.org).\nFor example, expect major image version bump on incompatible changes, like removing the Python version which has reached its end-of-life or changing a base image.\n\nFor production use, it's recommended to pin both tox and image versions (e.g., `31z4/tox:4.4.5-2.1.1`).\n\n## License\n\nView license information for [tox](https://github.com/tox-dev/tox/blob/main/LICENSE) and [Python 3](https://docs.python.org/3/license.html).\n\nAs with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F31z4%2Ftox-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F31z4%2Ftox-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F31z4%2Ftox-docker/lists"}