diff options
author | Alice Frosi <afrosi@redhat.com> | 2023-02-16 10:58:23 +0100 |
---|---|---|
committer | Alice Frosi <afrosi@redhat.com> | 2023-02-16 10:58:23 +0100 |
commit | 38d3e1d48ec7a657fb893f668400a583fdb31127 (patch) | |
tree | faaedacf23b5fb4de8f66498da6dd96af07cf2ff /tests/integration/README.md | |
parent | fe5c40a83620a870e32777b779fbbd2833d4db13 (diff) | |
download | seitan-38d3e1d48ec7a657fb893f668400a583fdb31127.tar seitan-38d3e1d48ec7a657fb893f668400a583fdb31127.tar.gz seitan-38d3e1d48ec7a657fb893f668400a583fdb31127.tar.bz2 seitan-38d3e1d48ec7a657fb893f668400a583fdb31127.tar.lz seitan-38d3e1d48ec7a657fb893f668400a583fdb31127.tar.xz seitan-38d3e1d48ec7a657fb893f668400a583fdb31127.tar.zst seitan-38d3e1d48ec7a657fb893f668400a583fdb31127.zip |
test: add howto setup integration tests
Signed-off-by: Alice Frosi <afrosi@redhat.com>
Diffstat (limited to 'tests/integration/README.md')
-rw-r--r-- | tests/integration/README.md | 47 |
1 files changed, 47 insertions, 0 deletions
diff --git a/tests/integration/README.md b/tests/integration/README.md new file mode 100644 index 0000000..cc99ead --- /dev/null +++ b/tests/integration/README.md @@ -0,0 +1,47 @@ +# Howto setup and run the integration tests + +The integration tests require access to podman socket activation (root) as +seitan requires high privileges. + +1. Enable podman: +```bash +$ sudo systemctl enable podman +$ sudo systemctl startpodman +``` + +2. Build the container images needed for the tests: For sake of simplicity, the + build requires root to be ready to be used. Otherwise, you can build using +rootless, and then either pushing them to a registry or loading them into the +image storage of root podman. +```bash +$ build-test-images +``` + +3. Create a python virtual environment to install the python packages (this is + needed only the first time): +```bash +$ python -m venv venv +$ ls venv/ +bin include lib lib64 pyvenv.cfg +``` + +4. Enable the virtual environment: +```bash +$ source venv/bin/activate +(venv) $ +``` + +5. Install the required python packages: +```bash +(venv) $ pip install -r tests/integration/requirements.txt +``` + +6. Run the tests: +``` +(venv) $ sudo -E PATH=$PATH make test-integration +``` + +7. Exit from the virtual environment: +```bash +(venv) $ deactivate +``` |