ZT_TEST(3)

📦 version 0.3.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 zt_test(3) — the LOCAL manual, bestie edition 💖

okay so real quick before we get into it: this is zt_test(3), and it lives in the LOCAL section of your manual pages. yes that "UNTITLED()" thing up top is giving placeholder energy but we don't judge, we just vibe. let's GO 🦋

✨ NAME ✨

zt_test, zt_t — the private lil representation of test state 💅

like... the private one. not for you to poke at. it's giving backstage pass, iykyk.

🌸 SYNOPSIS 🌸

struct zt_test
typedef struct zt_test *zt_t

that's it. that's the whole synopsis. short and iconic, as she should be ✨

🎀 DESCRIPTION 🎀

okay so zt_test is an opaque type — meaning you can see her, you just can't touch her — and she holds the test state while a test is running. think of her as the main character carrying all the vibes so nobody else has to 🫶

the test type gets passed as an argument to each test function. like every single one. no skipping, no exceptions, fr fr.

and then — plot twist — she also gets passed to both zt_check() and zt_assert(), because that's how you alter test state. they need her. she's the moment. 👑

then there's zt_t, which is a typedef that exists purely to cut down on test case boilerplate size. she's the shorter, cuter nickname for the whole thing. less typing, same energy, slay. 💅

and internally? zt_test stores the outcome of the test — yes she's keeping receipts — plus all the data required for non-local exit, which is the whole thing you need when zt_assert() fails. it's giving emergency exit but make it ✨data structures✨.

🌈 HISTORY 🌈

  • zt_test first appeared in libzt 0.1 — an OG, a legend, a pioneer 🌟
  • zt_t first appeared in libzt 0.2 — the sequel that ate, no cap 🔥

💜 AUTHORS 💜

Zygmunt Krynicki <me@zygoon.pl>

(the genius behind all of this. we stan. 🫶)

🌟 SEE ALSO 🌟

bestie there's literally nothing here. it's just vibes and an empty SEE ALSO section. we love a mysterious queen 💀

and that's the whole page!! this was zt_test(3) from libzt 0.3.1, dated January 12, 2020 — yes she's vintage, she's timeless, she's a classic 🎀✨

mwah, go write some tests 💖

📦 where this page comes from