SPECRB(1)

🎀 specrb — the standalone test runner, bestie edition 🎀

okay so this is the manual for SPECRB(1), aka specrb, aka the little Ruby script that runs your tests and does NOT need you to write a Rakefile about it. it's giving "I got you, babe" energy fr fr 💖

---

✨ NAME ✨

specrb — a standalone test runner for test/spec and Test::Unit test suites. yes queen, both. 🫶

---

🌸 SYNOPSIS 🌸

specrb [OPTIONS] [FILES | -a ] [-- untouched arguments]

that's the whole vibe. files, or -a, or options, or honestly all of the above. 💅

---

💜 DESCRIPTION 💜

so specrb is a Ruby script that lets you run tests written with test/spec straight from the command line. it's not a one-trick pony either — it works for plain Test::Unit test suites too. main character energy. ✨

you've got two ways to feed it tests:

1. just name the test files you wanna run, like a normal person 🍓
2. let specrb go find ALL the tests in your project by itself using the -a switch (peep TEST/SPEC OPTIONS down below for the deets) 🦋

and because options are life, you can also throw various command-line options at it to pass parameters along to the Ruby interpreterm, or to tweak the behavior of test/spec and/or test/unit. customize your own little test-running experience, iykyk. 💅

---

🔥 RUBY OPTIONS 🔥

• -e, --eval LINE — evaluate a LINE of code. just one line, live your truth.
• -d, --debug — set debugging flags, which means $DEBUG gets set to true. detective mode: ON 🕵️
• -w, --warn — turn warnings on for your script. brace yourself bestie, it's gonna be chatty 😭
• -I, --include PATH — specify $LOAD_PATH. and yes, you can use this more than once — stack 'em up like scrunchies 👑
• -r, --require LIBRARY — require the LIBRARY, before executing your script. gotta load before you go, periodt.

---

🌈 TEST/SPEC OPTIONS: 🌈

• -s, --specdox — do AgileDox-like output. fancy formatting, we love to see it ✨
• --rdox — do AgileDox-like output with RDoc formatting. same energy, but make it RDoc 💅
• -a, --automatic — gather tests from ./test/, and include ./lib/. the "let the runner cook" option 🍓

---

⭐ TEST::UNIT OPTIONS: ⭐

• -n, --name NAME — runs tests matching regexp NAME. regexp, so be careful with your wildcards bestie 😌
• -t, --testcase TESTCASE — runs tests in TestCases matching regexp TESTCASE. same deal, but for the TestCase names 🧚

---

💖 COMMON OPTIONS: 💖

• -h, --help — show a message similar to this manpage. hi, that's this 💜
• --version — show version. short, sweet, iconic 🎀

---

👑 AUTHORS 👑

the test/spec library has been written by Christian Neukirchen <http://purl.org/net/chneukirchen>. legend behavior, no cap 💅

this manual page — inspired by the help message of specrb — has been written for the Debian Project by Cédric Boutillier (but may used by others). yes, "may used", we're keeping it, it's part of the lore 🫶

---

okay bestie that's the whole page, nothing skipped, nothing invented, all 40-ish options accounted for. slay. 🌸

and that's a wrap on the SPECRB(1) girlies ✨ this one's from the 2021-01-08 era of SPECRB(1) — go run some tests, you absolute icon 💖🦋🎀