You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
pi-hole/test
dependabot[bot] 8042d9e3fd
Bump tox from 4.13.0 to 4.14.1 in /test
7 months ago
..
README.md
__init__.py
_centos_8.Dockerfile
_centos_9.Dockerfile
_debian_10.Dockerfile
_debian_11.Dockerfile
_debian_12.Dockerfile Add tests for Debian 12 1 year ago
_fedora_38.Dockerfile
_fedora_39.Dockerfile Drop Fedora 36 and add Fedora 39 to the test suite 8 months ago
_ubuntu_20.Dockerfile
_ubuntu_22.Dockerfile
_ubuntu_23.Dockerfile Add Ubuntu 23 to test suite 1 year ago
conftest.py
requirements.txt Bump tox from 4.13.0 to 4.14.1 in /test 7 months ago
setup.py
test_any_automated_install.py Install FTL's development branch to get the latest features during tests 10 months ago
test_any_utils.py
test_centos_common_support.py
test_centos_fedora_common_support.py
test_fedora_support.py
tox.centos_8.ini
tox.centos_9.ini
tox.debian_10.ini
tox.debian_11.ini
tox.debian_12.ini Add tests for Debian 12 1 year ago
tox.fedora_38.ini
tox.fedora_39.ini Drop Fedora 36 and add Fedora 39 to the test suite 8 months ago
tox.ubuntu_20.ini
tox.ubuntu_22.ini
tox.ubuntu_23.ini Add Ubuntu 23 to test suite 1 year ago

README.md

Recommended way to run tests

Make sure you have Docker and Python w/pip package manager.

From command line all you need to do is:

  • pip install tox
  • tox

Tox handles setting up a virtual environment for python dependencies, installing dependencies, building the docker images used by tests, and finally running tests. It's an easy way to have travis-ci like build behavior locally.

Alternative py.test method of running tests

You're responsible for setting up your virtual env and dependencies in this situation.

py.test -vv -n auto -m "build_stage"
py.test -vv -n auto -m "not build_stage"

The build_stage tests have to run first to create the docker images, followed by the actual tests which utilize said images. Unless you're changing your dockerfiles you shouldn't have to run the build_stage every time - but it's a good idea to rebuild at least once a day in case the base Docker images or packages change.

How do I debug python?

Highly recommended: Setup PyCharm on a Docker enabled machine. Having a python debugger like PyCharm changes your life if you've never used it :)