xref: /sqlalchemy/tox.ini (revision 603f7d30)
16b051503SMike Bayer
29281e700SMike Bayer[tox]
3c312b3b2SMike Bayerenvlist = py
49281e700SMike Bayer
59281e700SMike Bayer[testenv]
649dfeda6SMike Bayer# note that we have a .coveragerc file that points coverage specifically
749dfeda6SMike Bayer# at ./lib/sqlalchemy, and *not* at the build that tox might create under .tox.
849dfeda6SMike Bayer# See the notes below for setenv for more detail.
949dfeda6SMike Bayer# also using --cov-append so that we can aggregate multiple runs together.
1049dfeda6SMike Bayer# Jenkins etc. need to call "coverage erase" externally.
1149dfeda6SMike Bayercov_args=--cov=sqlalchemy --cov-report term --cov-append --cov-report xml --exclude-tag memory-intensive --exclude-tag timing-intensive -k "not aaa_profiling"
1249dfeda6SMike Bayer
13f704f47aSMike Bayerinstall_command=python -m pip install {env:TOX_PIP_OPTS:} {opts} {packages}
1422800000SMike Bayer
15086ad9ceSMike Bayerusedevelop=
16086ad9ceSMike Bayer     cov: True
17d100bfcfSMike Bayer
18664290abSMike Bayerdeps=pytest!=3.9.1,!=3.9.2
193568e508SMike Bayer     pytest-xdist
205fb0138aSMike Bayer     greenlet
210396fb76SMike Bayer     mock; python_version < '3.3'
22cd03b8f0SMike Bayer     importlib_metadata; python_version < '3.8'
23897cd176SMike Bayer     postgresql: .[postgresql]
2406f1929bSTony Locke     postgresql: .[postgresql_asyncpg]; python_version >= '3'
2506f1929bSTony Locke     postgresql: .[postgresql_pg8000]; python_version >= '3'
26897cd176SMike Bayer     mysql: .[mysql]
27897cd176SMike Bayer     mysql: .[pymysql]
28603f7d30SGeorg Richter     mysql: .[mariadb_connector]; python_version >= '3'
29603f7d30SGeorg Richter
30603f7d30SGeorg Richter     # we should probably try to get mysql_connector back in the mix
31603f7d30SGeorg Richter     # as well
32603f7d30SGeorg Richter     # mysql: .[mysql_connector]; python_version >= '3'
33603f7d30SGeorg Richter
34897cd176SMike Bayer     oracle: .[oracle]
35897cd176SMike Bayer     mssql: .[mssql]
36d1fe8f43SMike Bayer
37d100bfcfSMike Bayer     cov: pytest-cov
389281e700SMike Bayer
3949dfeda6SMike Bayerwhitelist_externals=sh
4049dfeda6SMike Bayer
4149dfeda6SMike Bayer# PYTHONPATH - erased so that we use the build that's present
4249dfeda6SMike Bayer# in .tox as the SQLAlchemy library to be imported
4349dfeda6SMike Bayer#
4449dfeda6SMike Bayer# PYTHONUSERSITE - this *MUST* be set so that the ./lib/ import
4549dfeda6SMike Bayer# set up explicitly in test/conftest.py is *disabled*, again so that
4649dfeda6SMike Bayer# when SQLAlchemy is built into the .tox area, we use that and not the
4749dfeda6SMike Bayer# local checkout, at least when usedevelop=False
4849dfeda6SMike Bayer#
4949dfeda6SMike Bayer# BASECOMMAND - using an env variable here so we can use it
5049dfeda6SMike Bayer# as a substitution in a command (see https://bitbucket.org/hpk42/tox/issues/307/)
5149dfeda6SMike Bayer#
52ffb6fbf8SMike Bayer# only use --dropfirst option if we're *not* using -n;
53ffb6fbf8SMike Bayer# if -n is used, we're working in brand new DBs anyway, dropfirst
54ffb6fbf8SMike Bayer# will collide on CI environments
55f30e35baSMike Bayersetenv=
56f30e35baSMike Bayer    PYTHONPATH=
5749dfeda6SMike Bayer    PYTHONNOUSERSITE=1
58e2d4b2e7SMike Bayer    MEMUSAGE=--nomemory
5900309662SMike Bayer    BASECOMMAND=python -m pytest --log-info=sqlalchemy.testing
60086ad9ceSMike Bayer
613ceb87daSMike Bayer    WORKERS={env:TOX_WORKERS:-n4  --max-worker-restart=5}
623231e281SMike Bayer
63086ad9ceSMike Bayer    nocext: DISABLE_SQLALCHEMY_CEXT=1
64a54a0c6eSMike Bayer    cext: REQUIRE_SQLALCHEMY_CEXT=1
65086ad9ceSMike Bayer    cov: COVERAGE={[testenv]cov_args}
663231e281SMike Bayer    backendonly: BACKENDONLY=--backend-only
673231e281SMike Bayer    memusage: MEMUSAGE='-k test_memusage'
683231e281SMike Bayer
693231e281SMike Bayer    oracle: WORKERS={env:TOX_WORKERS:-n2  --max-worker-restart=5}
703231e281SMike Bayer    oracle: ORACLE={env:TOX_ORACLE:--db oracle}
713231e281SMike Bayer
729e6393c6SMike Bayer    sqlite: SQLITE={env:TOX_SQLITE:--db sqlite}
7379a53645SGord Thompson    sqlite_file: SQLITE={env:TOX_SQLITE_FILE:--db sqlite_file}
743231e281SMike Bayer
753231e281SMike Bayer    postgresql: POSTGRESQL={env:TOX_POSTGRESQL:--db postgresql}
7606f1929bSTony Locke    py3{,5,6,7,8,9,10,11}-postgresql: EXTRA_PG_DRIVERS={env:EXTRA_PG_DRIVERS:--dbdriver psycopg2 --dbdriver asyncpg?async_fallback=true --dbdriver pg8000}
773231e281SMike Bayer
783231e281SMike Bayer    mysql: MYSQL={env:TOX_MYSQL:--db mysql}
793231e281SMike Bayer    mysql: EXTRA_MYSQL_DRIVERS={env:EXTRA_MYSQL_DRIVERS:--dbdriver mysqldb --dbdriver pymysql}
80603f7d30SGeorg Richter    py3{,5,6,7,8,9,10,11}-mysql: EXTRA_MYSQL_DRIVERS={env:EXTRA_MYSQL_DRIVERS:--dbdriver mysqldb --dbdriver pymysql --dbdriver mariadbconnector}
813231e281SMike Bayer
8206f1929bSTony Locke
83f87570acSMike Bayer    mssql: MSSQL={env:TOX_MSSQL:--db mssql}
843231e281SMike Bayer
8579a53645SGord Thompson    oracle,mssql,sqlite_file: IDENTS=--write-idents db_idents.txt
86e2d4b2e7SMike Bayer    oracle,mssql,sqlite_file: MEMUSAGE=--nomemory
87f30e35baSMike Bayer
887f423e87SMike Bayer# tox as of 2.0 blocks all environment variables from the
897f423e87SMike Bayer# outside, unless they are here (or in TOX_TESTENV_PASSENV,
90077f26afSMike Bayer# wildcards OK).  Need at least these
927f423e87SMike Bayer
9349dfeda6SMike Bayer# for nocext, we rm *.so in lib in case we are doing usedevelop=True
949281e700SMike Bayercommands=
95c312b3b2SMike Bayer  cext: /bin/true
962efd89d0SMike Bayer  nocext: sh -c "rm -f lib/sqlalchemy/*.so"
973231e281SMike Bayer  {env:BASECOMMAND} {env:WORKERS} {env:SQLITE:} {env:POSTGRESQL:} {env:EXTRA_PG_DRIVERS:} {env:MYSQL:} {env:EXTRA_MYSQL_DRIVERS:} {env:ORACLE:} {env:MSSQL:} {env:BACKENDONLY:} {env:IDENTS:} {env:MEMUSAGE:} {env:COVERAGE:} {posargs}
9879a53645SGord Thompson  oracle,mssql,sqlite_file: python reap_dbs.py db_idents.txt
999281e700SMike Bayer
100d229360aSMike Bayer# thanks to https://julien.danjou.info/the-best-flake8-extensions/
1019281e700SMike Bayer[testenv:pep8]
102b9d9d416SMike Bayerbasepython = python3.7
103d229360aSMike Bayerdeps=
104d229360aSMike Bayer      flake8
105d229360aSMike Bayer      flake8-import-order
106d229360aSMike Bayer      flake8-builtins
107a55a1a41SMike Bayer      flake8-docstrings>=1.3.1
108d229360aSMike Bayer      flake8-rst-docstrings
109a55a1a41SMike Bayer      # flake8-rst-docstrings depdendency, leaving it here
110a55a1a41SMike Bayer      # in case it requires a version pin
111a55a1a41SMike Bayer      pydocstyle
112d229360aSMike Bayer      pygments
113d8378f45SFederico Caselli      black==19.10b0
114d8378f45SFederico Casellicommands =
1157ff6cf1eSMike Bayer     flake8 ./lib/ ./test/ ./examples/ setup.py doc/build/conf.py {posargs}
116d8378f45SFederico Caselli     black --check .
117c658540bSFederico Caselli
118c658540bSFederico Caselli# command run in the github action when cext are active.
119c658540bSFederico Caselli[testenv:github-cext]
120c658540bSFederico Casellicommands=
121e2d4b2e7SMike Bayer  python -m pytest {env:WORKERS} {env:SQLITE:} {env:POSTGRESQL:} {env:MYSQL:} {env:ORACLE:} {env:MSSQL:} {env:BACKENDONLY:} {env:IDENTS:} {env:MEMUSAGE:} {env:COVERAGE:} {posargs}
122c658540bSFederico Caselli  oracle,mssql,sqlite_file: python reap_dbs.py db_idents.txt
123c658540bSFederico Caselli
124c658540bSFederico Caselli# command run in the github action when cext are not active.
125c658540bSFederico Caselli[testenv:github-nocext]
126c658540bSFederico Casellicommands=
127e2d4b2e7SMike Bayer  python -m pytest {env:WORKERS} {env:SQLITE:} {env:POSTGRESQL:} {env:MYSQL:} {env:ORACLE:} {env:MSSQL:} {env:BACKENDONLY:} {env:IDENTS:} {env:MEMUSAGE:} {env:COVERAGE:} {posargs}
1287ff6cf1eSMike Bayer  oracle,mssql,sqlite_file: python reap_dbs.py db_idents.txt