{"id":22474,"library":"tox-gh","title":"tox-gh","description":"Seamless integration of tox into GitHub Actions. Automatically detects GitHub Actions environment variables for parallel tox execution and job summaries. Latest version: 1.7.1, requires Python >=3.10. Release cadence: irregular.","status":"active","version":"1.7.1","language":"python","source_language":"en","source_url":"https://github.com/tox-dev/tox-gh","tags":["tox","github-actions","ci","testing","plugin"],"install":[{"cmd":"pip install tox-gh","lang":"bash","label":"Install tox-gh"}],"dependencies":[{"reason":"tox-gh is a plugin for tox; tox must be installed.","package":"tox","optional":false}],"imports":[],"quickstart":{"code":"name: CI\non: [push, pull_request]\njobs:\n  test:\n    runs-on: ubuntu-latest\n    strategy:\n      matrix:\n        python: ['3.10', '3.11', '3.12']\n    steps:\n      - uses: actions/checkout@v4\n      - uses: actions/setup-python@v5\n        with:\n          python-version: ${{ matrix.python }}\n      - name: Install dependencies\n        run: pip install tox tox-gh\n      - name: Run tox\n        run: tox","lang":"python","description":"Minimal GitHub Actions workflow using tox-gh. The plugin is activated automatically; no import or special configuration needed."},"warnings":[{"fix":"Update your CI runners to use Python 3.10 or later.","message":"Drop of Python 3.9 support in v1.6.0. Upgrade to Python >=3.10 to use tox-gh >=1.6.0.","severity":"breaking","affected_versions":">=1.6.0"},{"fix":"Provide fallback: use condition like `if: ${{ github.actions }}` or check `GITHUB_ACTIONS` env var in scripts.","message":"tox-gh only works inside GitHub Actions. It will fail or misbehave if run locally or in other CI systems.","severity":"gotcha","affected_versions":"all"},{"fix":"Remove usage of `tox-gh-action` composite action; just `pip install tox tox-gh` and run `tox`.","message":"The `tox-gh-action` is deprecated in favor of `tox-gh`. Use the pip-installable plugin approach with a GitHub Actions workflow step.","severity":"deprecated","affected_versions":">=1.0"},{"fix":"Avoid overriding `tox_envdir` or `work_dir` when using tox-gh.","message":"If you set `tox_envdir` or customize tox directory, tox-gh may not detect the environment correctly for parallelism or summary.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run only in GitHub Actions workflow; for local testing, remove tox-gh or set a dummy GITHUB_ENV variable.","cause":"tox-gh is being run outside GitHub Actions (e.g., locally).","error":"tox-gh: GITHUB_ENV not set"},{"fix":"Upgrade tox to version >=4.0: `pip install --upgrade tox>=4.0`.","cause":"Using an outdated version of tox that doesn't support the plugin system (tox <4.0).","error":"AttributeError: module 'tox' has no attribute 'plugins'"},{"fix":"Ensure both tox and tox-gh are up-to-date: `pip install --upgrade tox tox-gh`.","cause":"Version mismatch between tox-gh and tox.","error":"Error: The `tox-gh` plugin is not compatible with this version of tox. Please update tox."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}