docker-pi-hole/TESTING.md

# Prerequisites 

Make sure you have docker, python, and pip.  I won't cover how to install those here, please search the internet for that info if you need it.

# Running tests locally

Travis-ci auto runs tests during pull requests (PR) but it only has 2 cores and if you have more/faster cpus your PC's local tests will be faster and you'll have quicker feedback loops than continually pushing to have your PR run travis-ci

After you have the prereqs, to get the required pip packages run: `pip install -r requirements.txt`

To run the Dockerfile templating, image build, and tests all in one command just run: `tox`

# Local image names

Docker images built by `tox` or `python Dockerfile.py` are named the same but stripped of the `pihole/` docker repository namespace.

e.g. `pi-hole:debian_amd64` or `pi-hole-multiarch:debian_arm64`

You can run the multiarch images on an amd64 development system if you [enable binfmt-support as described in the multiarch image docs](https://hub.docker.com/r/multiarch/multiarch/debian-debootstrap/)

`docker run --rm --privileged multiarch/qemu-user-static:register --reset`
Create TESTING.md 2017-10-16 22:38:59 +02:00			`# Prerequisites`

			`Make sure you have docker, python, and pip. I won't cover how to install those here, please search the internet for that info if you need it.`

			`# Running tests locally`

			`Travis-ci auto runs tests during pull requests (PR) but it only has 2 cores and if you have more/faster cpus your PC's local tests will be faster and you'll have quicker feedback loops than continually pushing to have your PR run travis-ci`

			After you have the prereqs, to get the required pip packages run: `pip install -r requirements.txt`

update testing readme for tox 2017-10-17 07:21:43 +02:00			To run the Dockerfile templating, image build, and tests all in one command just run: `tox`
Create TESTING.md 2017-10-16 22:38:59 +02:00
update testing readme for tox 2017-10-17 07:21:43 +02:00			`# Local image names`

more /diginc/ references updated Signed-off-by: Adam Hill <adam@diginc.us> 2018-08-04 18:44:19 +02:00			Docker images built by `tox` or `python Dockerfile.py` are named the same but stripped of the `pihole/` docker repository namespace.
update testing readme for tox 2017-10-17 07:21:43 +02:00
Update way too much - Tox py3.7 + pipenv - Python3 Dockerfile.py - Dockerfile.py tags remote instead of just local image names now - Circle.sh instead of in-line circle.yml script breakout - probably other stuff I forgot - Docker images build during the tests should hopefullly now be available at the deploy job workflow thanks to shared docker layers. - Rename aarch64 to arm64 to reduce custom map 2020-01-14 15:37:44 +01:00			e.g. `pi-hole:debian_amd64` or `pi-hole-multiarch:debian_arm64`
update testing readme for tox 2017-10-17 07:21:43 +02:00
delete all the alpine 2018-01-04 03:09:47 +01:00			`You can run the multiarch images on an amd64 development system if you [enable binfmt-support as described in the multiarch image docs](https://hub.docker.com/r/multiarch/multiarch/debian-debootstrap/)`
update testing readme for tox 2017-10-17 07:21:43 +02:00
			`docker run --rm --privileged multiarch/qemu-user-static:register --reset`