Python versions

python_deploy_version

The version of Python to use on Travis when deploying to PyPI, Anaconda and GitHub releases.

Example:

python_deploy_version: 3.8

Required: no

Default: 3.8

Type: String or Float

python_versions

A list of the version(s) of Python to use when performing tests with Tox, e.g.

python_versions:
  - 3.6
  - 3.7
  - 3.8
  - pypy3

If undefined the value of python_deploy_version is used instead.

For more advanced configuration, this may instead be a mapping of version number strings to mappings of options, e.g.:

python_versions:
  3.6:
  3.7:
  3.8:
  pypy3:
    experimental: false

PyPy 3.7 and prerelease versions of CPython are treated as experimental by default unless overridden.

Changed in version 2022.4.4: Added support for mappings as well as lists.

Required: no

Default: The value of _default_python_versions

Type: Sequence or Mapping

requires_python

The minimum required version of Python.

Example:

requires_python: 3.6.1

New in version 2021.2.18.

Required: no

Default: None

Type: String or Float

third_party_version_matrix

A mapping of third party library names to the version number(s) to test.

The special value “latest” indicates the latest version of the library should be used.

third_party_version_matrix:
  attrs:
  - 19.3
  - 20.1
  - 20.2
  - latest

This would translate into the following tox testenvs:

py36-attrs{19.3,20.1,20.2,latest}

and the following tox requirements:

attrs19.3: attrs~=19.3.0
attrs20.1: attrs~=20.1.0
attrs20.2: attrs~=20.2.0
attrslatest: attrs

which is <name>~={<version>).0.

New in version 2020.12.21.

Note

Currently matrices are only supported for a single third-party requirement.

Required: no

Default: { }

Type: Mapping of String to Sequence of String or Float

The lowest version of Python given above is used to set the minimum supported version for Pip, PyPI, setuptools etc.