ipa-run-tests(1)

💖 ipa-run-tests — the FreeIPA test suite runner, bestie edition 💖

okay so real talk, this is the ipa-run-tests page from the FreeIPA Manual Pages, and I am so excited to walk you through it. grab a snack 🍓, we're running tests.

---

✨ NAME ✨

ipa-run-tests — run the FreeIPA test suite 🧚

---

✨ SYNOPSIS ✨

ipa-run-tests [options]

---

🌸 DESCRIPTION 🌸

so ipa-run-tests is literally a wrapper around Pytest that runs the FreeIPA test suite. that's the whole vibe. 💅

it's meant for developer testing and for continuous integration systems. both. she contains multitudes. 👑

and here's the fun part — you can pick just a subset of the entire test suite by giving a test file that's relative to the ipatests package. like, say, this little cutie:

ipa-run-tests test_integration/test_simple_replication.py

yes bestie, one file. you don't have to run the whole thing. live your truth. 🌈

---

✨ OPTIONS ✨

every single command-line option gets passed straight through to the underlying Pytest runner. all of them. no gatekeeping. 🫶

for the complete list, go look at pytest --help.

that's it. that's the options section. the power is in pytest's hands, and honestly? iconic.

---

💀 EXIT STATUS 💀

running pytest can land you in six different exit codes, and each one is telling you a story. let's break it down:

• Exit code 0 — all tests were collected and passed successfully 🎉 slay.
• Exit code 1 — tests were collected and run but some of the tests failed 😭 we've all been there.
• Exit code 2 — test execution was interrupted by the user 🙈 you did that.
• Exit code 3 — internal error happened while executing tests 💀 not your fault, but still.
• Exit code 4 — pytest command line usage error 🌸 check your flags, bestie.
• Exit code 5 — no tests were collected 🫠 the silence. the emptiness.

---

🎀 CONFIGURATION 🎀

pls go see ipa-test-config(1) for a description of the configuration environment variables. she's got the lore. 📖✨

---

🔥 REFERENCES 🔥

a full description of the FreeIPA testing is available at https://www.freeipa.org/page/Testing — go read it, it's giving resources. 🌟

---

and that's the whole page!! 💖 this was FreeIPA, dated Aug 29 2013, and you were reading ipa-run-tests(1) the whole time 🎀✨ mwah, go run those tests, you've got this 👑🦋