tox.ini

# Generated from:
# https://github.com/plone/meta/tree/main/config/default
# See the inline comments on how to expand/tweak this configuration file
[tox]
# We need 4.4.0 for constrain_package_deps.
min_version = 4.4.0
envlist =
    lint
    test
    dependencies


##
# Add extra configuration options in .meta.toml:
#  [tox]
#  envlist_lines = """
#      my_other_environment
#  """
#  config_lines = """
#  my_extra_top_level_tox_configuration_lines
#  """
##

[testenv]
skip_install = true
allowlist_externals =
    echo
    false
# Make sure typos like `tox -e formaat` are caught instead of silently doing nothing.
# See https://github.com/tox-dev/tox/issues/2858.
commands =
    echo "Unrecognized environment name {envname}"
    false

##
# Add extra configuration options in .meta.toml:
#  [tox]
#  testenv_options = """
#  basepython = /usr/bin/python3.8
#  """
##

[testenv:init]
description = Prepare environment
skip_install = true
commands =
    echo "Initial setup complete"


[testenv:format]
description = automatically reformat code
skip_install = true
deps =
    pre-commit
commands =
    pre-commit run -a pyupgrade
    pre-commit run -a isort
    pre-commit run -a black
    pre-commit run -a zpretty

[testenv:lint]
description = run linters that will help improve the code style
skip_install = true
deps =
    pre-commit
commands =
    pre-commit run -a

[testenv:dependencies]
description = check if the package defines all its dependencies
skip_install = true
deps =
    build
    z3c.dependencychecker==2.14.3
commands =
    python -m build --sdist
    dependencychecker

[testenv:dependencies-graph]
description = generate a graph out of the dependencies of the package
skip_install = false
allowlist_externals =
    sh
deps =
    pipdeptree==2.5.1
    graphviz  # optional dependency of pipdeptree
commands =
    sh -c 'pipdeptree --exclude setuptools,wheel,pipdeptree,zope.interface,zope.component --graph-output svg > dependencies.svg'

[testenv:test]
description = run the distribution tests
use_develop = true
skip_install = false
constrain_package_deps = true
set_env =
    ROBOT_BROWSER=headlesschrome

##
# Specify extra test environment variables in .meta.toml:
#  [tox]
#  test_environment_variables = """
#      PIP_EXTRA_INDEX_URL=https://my-pypi.my-server.com/
#  """
#
# Set constrain_package_deps .meta.toml:
#  [tox]
#  constrain_package_deps = "false"
##
deps =
    zope.testrunner
    -c https://dist.plone.org/release/6.0-dev/constraints.txt

##
# Specify additional deps in .meta.toml:
#  [tox]
#  test_deps_additional = "-esources/plonegovbr.portal_base[test]"
#
# Specify a custom constraints file in .meta.toml:
#  [tox]
#  constraints_file = "https://my-server.com/constraints.txt"
##
commands =
    zope-testrunner --all --test-path={toxinidir}/src -s collective.hardening {posargs}
extras =
    test

##
# Add extra configuration options in .meta.toml:
#  [tox]
#  test_extras = """
#      tests
#      widgets
#  """
##

[testenv:coverage]
description = get a test coverage report
use_develop = true
skip_install = false
constrain_package_deps = true
set_env =
    ROBOT_BROWSER=headlesschrome

##
# Specify extra test environment variables in .meta.toml:
#  [tox]
#  test_environment_variables = """
#      PIP_EXTRA_INDEX_URL=https://my-pypi.my-server.com/
#  """
##
deps =
    coverage
    zope.testrunner
    -c https://dist.plone.org/release/6.0-dev/constraints.txt

commands =
    coverage run --branch --source collective.hardening {envbindir}/zope-testrunner --quiet --all --test-path={toxinidir}/src -s collective.hardening {posargs}
    coverage report -m --format markdown
    coverage xml
    coverage html
extras =
    test


[testenv:release-check]
description = ensure that the distribution is ready to release
skip_install = true
deps =
    twine
    build
    -c https://dist.plone.org/release/6.0-dev/constraints.txt

commands =
    python -m build --sdist
    twine check dist/*

# XXX: this is commented because plone.app.discussion wrongly depends on plone.api
#      See https://github.com/plone/plone.app.discussion/pull/253
# [testenv:circular]
# description = ensure there are no cyclic dependencies
# use_develop = true
# skip_install = false
# # Here we must always constrain the package deps to what is already installed,
# # otherwise we simply get the latest from PyPI, which may not work.
# constrain_package_deps = true
# set_env =
#
# ##
# # Specify extra test environment variables in .meta.toml:
# #  [tox]
# #  test_environment_variables = """
# #      PIP_EXTRA_INDEX_URL=https://my-pypi.my-server.com/
# #  """
# ##
# allowlist_externals =
#     sh
# deps =
#     pipdeptree
#     pipforester
#     -c https://dist.plone.org/release/6.0-dev/constraints.txt
#
# commands =
#     # Generate the full dependency tree
#     sh -c 'pipdeptree -j > forest.json'
#     # Generate a DOT graph with the circular dependencies, if any
#     pipforester -i forest.json -o forest.dot --cycles
#     # Report if there are any circular dependencies, i.e. error if there are any
#     pipforester -i forest.json --check-cycles -o /dev/null


##
# Add extra configuration options in .meta.toml:
#  [tox]
#  extra_lines = """
#  _your own configuration lines_
#  """
##