Usage Within Tox

Running coveralls-python from within a tox environment (v2.0 and above) requires an additional step; since coveralls-python relies on environment variables to function, you’ll need to configure tox to capture those variables using the passenv configuration option in your tox.ini.

For example, on TravisCI:

[tox]
envlist = py34,py35,py36,py37,py38

[testenv]
passenv = TRAVIS TRAVIS_*
deps =
    coveralls
commands =
    coverage run --source=yourpackagename setup.py test
    coveralls

If you are configuring coveralls-python with environment variables, you should also pass those. See Configuration for more details.

AppVeyor

passenv = APPVEYOR APPVEYOR_*

All variables:

  • APPVEYOR

  • APPVEYOR_BUILD_ID

  • APPVEYOR_REPO_BRANCH

  • APPVEYOR_PULL_REQUEST_NUMBER

BuildKite

passenv = BUILDKITE BUILDKITE_*

All variables:

  • BUILDKITE

  • BUILDKITE_JOB_ID

  • BUILDKITE_BRANCH

CircleCI

passenv = CIRCLECI CIRCLE_* CI_PULL_REQUEST

All variables:

  • CIRCLECI

  • CIRCLE_BUILD_NUM

  • CIRCLE_BRANCH

  • CI_PULL_REQUEST

Github Actions

passenv = GITHUB_*

All variables:

  • GITHUB_ACTIONS

  • GITHUB_REF

  • GITHUB_SHA

  • GITHUB_HEAD_REF

  • GITHUB_REPOSITORY

  • GITHUB_RUN_ID

  • GITHUB_TOKEN

Jenkins

passenv = JENKINS_HOME BUILD_NUMBER GIT_BRANCH CI_PULL_REQUEST

All variables:

  • JENKINS_HOME

  • BUILD_NUMBER

  • GIT_BRANCH

  • CI_PULL_REQUEST

TravisCI

passenv = TRAVIS TRAVIS_*

All variables:

  • TRAVIS

  • TRAVIS_JOB_ID

  • TRAVIS_BRANCH

  • TRAVIS_PULL_REQUEST

SemaphoreCI

Classic

passenv = SEMAPHORE SEMAPHORE_EXECUTABLE_UUID SEMAPHORE_JOB_UUID SEMAPHORE_BRANCH_ID BRANCH_NAME

All variables:

  • SEMAPHORE

  • SEMAPHORE_EXECUTABLE_UUID

  • SEMAPHORE_JOB_UUID

  • SEMAPHORE_BRANCH_ID

  • BRANCH_NAME

2.0

passenv = SEMAPHORE SEMAPHORE_WORKFLOW_ID SEMAPHORE_JOB_ID SEMAPHORE_GIT_PR_NUMBER BRANCH_NAME

All variables:

  • SEMAPHORE

  • SEMAPHORE_WORKFLOW_ID

  • SEMAPHORE_JOB_ID

  • SEMAPHORE_GIT_PR_NUMBER

  • BRANCH_NAME