[tox]
minversion = 4.28.0
# specify virtualenv here to keep local runs consistent with the
# gate (it sets the versions of pip, setuptools, and wheel)
requires = virtualenv>=20.17.1
envlist = py3,compliance,pep8

[testenv]
usedevelop = true
passenv =
  *_proxy
  *_PROXY
setenv =
  OS_STDOUT_CAPTURE=1
  OS_STDERR_CAPTURE=1
  OS_TEST_TIMEOUT=60
  OS_TEST_PATH=./cinder/tests/unit
  PYTHONDONTWRITEBYTECODE=1
  OS_CINDER_DISABLE_EVENTLET_PATCHING=False
constraints =
  {env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/master}
deps =
  -r{toxinidir}/test-requirements.txt
  -r{toxinidir}/requirements.txt
# By default stestr will set concurrency
# to ncpu, to specify something else use
# the concurrency=<n> option.
# call ie: 'tox -epy27 -- --concurrency=4'
commands =
  stestr run --random {posargs}
  stestr slowest
allowlist_externals =
  find

[testenv:py{3,311,312,313,314,315}-threading]
setenv =
  {[testenv]setenv}
  # Use threading
  OS_CINDER_DISABLE_EVENTLET_PATCHING=True

[testenv:functional]
setenv =
  OS_TEST_PATH = ./cinder/tests/functional

[testenv:functional-py{3,311,312,313,314}]
setenv =
  {[testenv:functional]setenv}

[testenv:api-samples]
setenv =
  GENERATE_SAMPLES=True
  PYTHONHASHSEED=0
commands =
  find . -ignore_readdir_race -type f -name "*.pyc" -delete
  stestr --test-path=./cinder/tests/functional/api_sample_tests run {posargs}
  stestr slowest

[testenv:compliance]
setenv =
  OS_TEST_PATH = ./cinder/tests/compliance

[testenv:pep8]
allowlist_externals =
  {toxinidir}/tools/config/check_uptodate.sh
  {toxinidir}/tools/check_exec.py
deps =
  {[testenv]deps}
  pre-commit
commands =
  pre-commit run --all-files --show-diff-on-failure
  {toxinidir}/tools/config/check_uptodate.sh

[testenv:fast8]
allowlist_externals =
  {toxinidir}/tools/fast8.sh
commands =
  {toxinidir}/tools/fast8.sh
passenv = FAST8_NUM_COMMITS

[testenv:pylint]
allowlist_externals =
  {toxinidir}/tools/coding-checks.sh
deps =
  {[testenv]deps}
  pylint==3.0.2
commands =
  {toxinidir}/tools/coding-checks.sh --pylint {posargs:all}

[testenv:cover]
# Also do not run test_coverage_ext tests while gathering coverage as those
# tests conflict with coverage.
setenv =
    {[testenv]setenv}
    PYTHON=coverage run --source cinder --parallel-mode
commands =
    stestr run {posargs}
    coverage combine
    coverage html -d cover
    coverage xml -o cover/coverage.xml

[testenv:genconfig]
sitepackages = False
commands =
  oslo-config-generator --config-file=tools/config/cinder-config-generator.conf

[testenv:genpolicy]
commands =
  oslopolicy-sample-generator --config-file=tools/config/cinder-policy-generator.conf

[testenv:genopts]
sitepackages = False
commands =
  python tools/config/generate_cinder_opts.py

[testenv:venv]
deps =
  {[testenv]deps}
  reno
commands =
  {posargs}

[testenv:docs]
allowlist_externals = rm
deps =
  -r{toxinidir}/doc/requirements.txt
  doc8
commands =
  doc8
  rm -rf doc/source/contributor/api doc/build/html doc/build/doctrees
  sphinx-build -W -j auto -b html -d doc/build/doctrees doc/source doc/build/html
  # Test the redirects. This must run after the main docs build
  whereto doc/build/html/.htaccess doc/test/redirect-tests.txt

[testenv:pdf-docs]
deps =
  {[testenv:docs]deps}
commands =
  rm -fr doc/source/contributor/api/
  rm -fr doc/build/pdf
  sphinx-build -W -b latex doc/source doc/build/pdf
  make -C doc/build/pdf
allowlist_externals =
  make
  rm

[testenv:api-ref]
allowlist_externals =
  rm
deps =
  {[testenv:docs]deps}
commands =
  rm -rf api-ref/build
  sphinx-build -W -b html -d api-ref/build/doctrees api-ref/source api-ref/build/html/

[testenv:releasenotes]
deps =
  {[testenv:docs]deps}
commands =
  sphinx-build -a -E -W -j auto -d releasenotes/build/doctrees -b html releasenotes/source releasenotes/build/html

[testenv:gendriverlist]
sitepackages = False
commands =
  python {toxinidir}/tools/generate_driver_list.py

[testenv:bandit]
deps =
  {[testenv]deps}
  bandit==1.6.0
commands =
  bandit -r cinder -n5 -x cinder/tests/* -ll

[testenv:bandit-baseline]
deps =
  bandit==1.6.0
commands =
  bandit-baseline -r cinder -n5 -x cinder/tests/* -ii -ll

[testenv:bindep]
# Do not install any requirements. We want this to be fast and work even if
# system dependencies are missing, since it's used to tell you what system
# dependencies are missing! This also means that bindep must be installed
# separately, outside of the requirements files, and develop mode disabled
# explicitly to avoid unnecessarily installing the checked-out repo too
skip_install = True
usedevelop = False
deps = bindep
commands =
  bindep {posargs}

[testenv:mypy]
description =
  Run type checks.
deps =
  {[testenv]deps}
  types-decorator
  types-requests
  types-lxml
  types-tabulate
  mypy~=2.0.0
commands =
  mypy --cache-dir="{envdir}/mypy_cache" {posargs}

[flake8]
# Following checks are ignored on purpose.
#
# E251 unexpected spaces around keyword / parameter equals
# reason: no improvement in readability
# E402 module level import not at top of file
# reason: there are numerous places where we import modules
#  later for legitimate reasons
#
# W503 line break before binary operator
# reason: pep8 itself is not sure about this one and
#  reversed this rule in 2016
# W504 line break after binary operator
# reason: no agreement on this being universally
#  preferable for our code.  Disabled to keep checking
#  tools from getting in our way with regards to this.
# H101 include name with TODO
#  reason: no real benefit
# G200 Logging statements should not include the exception
#  reason: Many existing cases of this that may be legitimate
# F824 temporary skip to bump to hacking 8.0.0
ignore = E251,E402,W503,W504,H101,G200,F824
# H904 Delay string interpolations at logging calls.
enable-extensions = H106,H203,H904
exclude = .git,.venv,.tox,dist,tools,doc/ext,*egg,build
max-complexity = 30
application-import-names = cinder
import-order-style = pep8

[flake8:local-plugins]
extension =
  N322 = checks:no_mutable_default_args
  N323 = checks:check_explicit_underscore_import
  C301 = checks:check_datetime_now
  C303 = checks:check_no_print_statements
  C309 = checks:no_test_log
  C310 = checks:CheckLoggingFormatArgs
  C311 = checks:CheckOptRegistrationArgs
  C312 = checks:no_translate_logs
  C313 = checks:validate_assertTrue
  C336 = checks:dict_constructor_with_list_copy
  C337 = checks:no_third_party_mock
  C338 = checks:no_log_warn
paths = ./cinder/tests/hacking

[doc8]
ignore-path = .venv,.git,.tox,*.egg-info,doc/src/api,doc/source/drivers.rst,doc/build,.eggs,doc/source/configuration/tables,./*.txt,releasenotes,doc/source/contributor/api,doc/test
extension = .txt,.rst,.inc

[testenv:ruff]
deps =
  {[testenv]deps}
  ruff
commands =
  ruff check {toxinidir}/cinder {posargs}

[hacking]
import_exceptions = typing