TESSRUN(1)

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

💖 TESSRUN(1) — bestie's guide to running your TESS tests 💖

okay so welcome to the tessrun page, section 1 of the manual, and honestly? she's a little legend.

✨ NAME ✨

tessrun — a convenience script for running TESS scripts en masse, like a girlboss 🎀

🌸 SYNOPSIS 🌸

tessrun [ -h ] [ -l ] [ -l ] [ application [ args ...] ]
not me pointing out that yes, -l really does show up twice in there. it's in the original, so it's staying. 💅

🦋 DESCRIPTION 🦋

okay so here's the vibe: the tessrun script is part of TESS, which stands for the (Te)st (S)ystem for (S)-Lang. she's here to make your life easier, bestie. 🫶

her whole thing is simplifying the invocation — typically when you're inside a Makefile — of TESS-based automated regression suites. like, you don't have to do it manually, she handles it.

so here's what happens: every single test in the current directory gets automatically loaded into the S-Lang interpreter — inside slsh, by default — and then executed. every test, no cap. they're marked by a .t suffix, so that's how she knows who's invited to the party. ✨

and the exit status? tessrun returns 1 if any tests fail, otherwise 0. that's it. that's the whole report card. 😭

💅 OPTIONS 💅

  • -h — outputs this short help text. the "hey bestie, here's how to use me" move. 🙈
  • -l — supports local execution of examples (before install). so you can vibe with your examples before they're all installed and official. 🔥
  • -v — verbose mode. she will tell you everything, and honestly, sometimes you need that. 👑
  • application [ args ...] — swaps out the use of slsh and puts in whatever application you want, plus any optional arguments you feel like passing. it's giving customizable. 🌈

⭐ AUTHOR ⭐

the author of TESS is Michael S. Noble <mnoble@space.mit.edu>. 🌟

Rafael Laboissiere <rafael@debian.org> created the TESS package for Debian and helped author this manual page. 🫶

permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or any later version published by the Free Software Foundation. 🎀

on Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL — go read it if you want the full legal tea, bestie. 📜

👑 SEE ALSO 👑

on Debian systems the reference manual for TESS can be found at:

/usr/share/doc/slang-tess/tess.txt.gz

it's also packaged in text and PDF forms in the source distribution. so many formats, so many options, we love that for us. 💖

and that's the whole page, bestie!! this one's dated 02 November 2005 and comes from the TESSRUN(1) manual — iconic, timeless, still serving. slay. 💅✨🦋

📦 where this page comes from