Murzaby/pi-hole
1
0
Fork 0
mirror of https://github.com/pi-hole/pi-hole.git synced 2026-06-28 04:21:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
pi-hole/test
History
darkexplosiveqwx af4df3fa75
Merge branch 'development' into april-os
2026-05-21 22:24:50 +02:00
..
_alpine_3_21.Dockerfile test: bake BATS libraries into test images at build time 2026-05-21 19:30:20 +01:00
_alpine_3_22.Dockerfile test: bake BATS libraries into test images at build time 2026-05-21 19:30:20 +01:00
_alpine_3_23.Dockerfile test: bake BATS libraries into test images at build time 2026-05-21 19:30:20 +01:00
_centos_9.Dockerfile test: bake BATS libraries into test images at build time 2026-05-21 19:30:20 +01:00
_centos_10.Dockerfile test: bake BATS libraries into test images at build time 2026-05-21 19:30:20 +01:00
_debian_11.Dockerfile test: bake BATS libraries into test images at build time 2026-05-21 19:30:20 +01:00
_debian_12.Dockerfile test: bake BATS libraries into test images at build time 2026-05-21 19:30:20 +01:00
_debian_13.Dockerfile test: bake BATS libraries into test images at build time 2026-05-21 19:30:20 +01:00
_fedora_40.Dockerfile test: bake BATS libraries into test images at build time 2026-05-21 19:30:20 +01:00
_fedora_41.Dockerfile test: bake BATS libraries into test images at build time 2026-05-21 19:30:20 +01:00
_fedora_42.Dockerfile test: bake BATS libraries into test images at build time 2026-05-21 19:30:20 +01:00
_fedora_43.Dockerfile test: bake BATS libraries into test images at build time 2026-05-21 19:30:20 +01:00
_fedora_44.Dockerfile Add Fedora 44 and Ubuntu 26.04 LTS to tests 2026-04-29 20:27:39 +02:00
_ubuntu_20.Dockerfile test: bake BATS libraries into test images at build time 2026-05-21 19:30:20 +01:00
_ubuntu_22.Dockerfile test: bake BATS libraries into test images at build time 2026-05-21 19:30:20 +01:00
_ubuntu_24.Dockerfile test: bake BATS libraries into test images at build time 2026-05-21 19:30:20 +01:00
_ubuntu_26.Dockerfile Add Fedora 44 and Ubuntu 26.04 LTS to tests 2026-04-29 20:27:39 +02:00
README.md test: update README for BATS runner usage 2026-05-21 19:30:20 +01:00
run.sh test: split containers, simplify run_suite, improve distro error 2026-05-21 19:30:20 +01:00
test_automated_install.bats Remove spurious runUnattended=true from install test 2026-05-21 19:30:20 +01:00
test_fresh_install.bats Remove spurious runUnattended=true from install test 2026-05-21 19:30:20 +01:00
test_installer_ftl.bats Remove spurious runUnattended=true from install test 2026-05-21 19:30:20 +01:00
test_network.bats Remove spurious runUnattended=true from install test 2026-05-21 19:30:20 +01:00
test_selinux.bats Remove spurious runUnattended=true from install test 2026-05-21 19:30:20 +01:00
test_utils.bats test: split containers, simplify run_suite, improve distro error 2026-05-21 19:30:20 +01:00
tox.fedora_44.ini Add Fedora 44 and Ubuntu 26.04 LTS to tests 2026-04-29 20:27:39 +02:00
tox.ubuntu_26.ini Add Fedora 44 and Ubuntu 26.04 LTS to tests 2026-04-29 20:27:39 +02:00

README.md

Recommended way to run tests

The test suite is implemented with BATS and runs inside distro-specific Docker containers.

Requirements

  • Docker (with buildx support)
  • Bash shell

Run tests

From the repository root, run:

bash test/run.sh --distro debian_12

test/run.sh will:

  • Build the distro test image from test/_<distro>.Dockerfile
  • Run the mock/function BATS suite in a fresh container
  • Run the fresh-install BATS suite in a separate fresh container

Available distros

If you are unsure which distro names are valid, run:

bash test/run.sh --help

The help output includes the current list of supported distros.

Optional: override BATS library versions

test/run.sh accepts optional environment variable overrides when building test images:

  • BATS_CORE_VER
  • BATS_SUPPORT_VER
  • BATS_ASSERT_VER
  • BATS_MOCK_VER
  • BATS_FILE_VER

Example:

BATS_CORE_VER=v1.14.0 DISTRO=debian_12 bash test/run.sh