ZT_MAIN(3)

✨ zt_main ✨

okay bestie, gather round, because this is the command line interface for running tests and she is lowkey the moment 💅. she lives in the LOCAL</> manual, section 3, and honestly? iconic.

---

🌸 NAME 🌸

zt_main — the command line interface for running tests, fr fr 🧚

---

🎀 SYNOPSIS 🎀

#include <zt.h>

int
zt_main(int argc, char **argv, char **envp, zt_test_suite_func tsuite);

like. look at her. so clean. so powerful. 🫶

---

💖 DESCRIPTION 💖

so zt_main takes all the familiar arguments you already know and love, plus one single test suite function — that's the tsuite bestie, she's the main character here 👑.

and then, depending on whatever you threw at it on the command line, it either:

• enumerates and prints some or all of the tests 📝, or
• actually executes some or all of them 🔥

some. or all. depends on the args. the args decide. the args are the vibe check. periodt.

---

⭐ RETURN VALUES ⭐

here's the tea ☕:

• when tests are executed, the return value is EXIT_SUCCESS or EXIT_FAILURE — basically a pass/fail report card and you WILL be seeing it 😭
• if the tests are only listed (no execution, just a lil peek 👀), the return value is always EXIT_SUCCESS. always. no cap.

---

🦋 SEE ALSO 🦋

go read these next, they're literally the besties:

• ZT_VISIT_TEST_CASE(3)
• ZT_VISIT_TEST_SUITE(3)

iykyk 💜

---

🌈 HISTORY 🌈

zt_main first appeared in libzt 0.1 — a true OG, we stan a humble origin story 🎀

---

💜 AUTHORS 💜

Zygmunt Krynicki <me@zygoon.pl> — thank you for your service, king 🫡👑

---

no cap, that's the whole page. go run some tests bestie, you got this 💅✨

and that's a wrap! this lil legend comes from libzt 0.3.1, dated January 12, 2020, and lives at zt_main(3) 🍓 bye bestie!! 🧚💖