TAP2JUNIT(1p)

📦
version 0.17 · 3 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

✨ TAP2JUNIT — the manual page bestie 💖

okay so real quick: this is TAP2JUNIT(1p), a lil Perl script that lives in your shell and does ONE thing beautifully — it takes TAP and turns it into JUnit. and it does it flawlessly, no cap. 🎀

🌸 NAME 🌸

tap2junit — converts TAP output to JUnit. that's the whole vibe. it's giving translator, but make it test reports. 💅

🦋 SYNOPSIS 🦋

tap2junit [options] <filename> <filename> ...

Options:
  --suffix <suffix>   Suffix for JUnit output files (default ".xml")
  --verbose           Display verbose status during conversion
  --name <name>       Provide explicit name for the JUnit test
  --help/-?           Display brief help message
  --man               Display full documentation

like, look at her. multiple filenames. options. so much range. ⭐

💜 DESCRIPTION 💜

tap2junit converts TAP output to JUnit. that's it, that's the thesis, that's the entire main character arc. 👑

so here's the tea: you hand it a list of files containing TAP results, and it creates a whole series of ????.junit.xml output files — each one holding the JUnit representation of the TAP that was chillin' inside the file you gave it. one in, one out. so satisfying fr fr. 🫶

and now for the iconic little twist: if you specify - as the filename, tap2junit will read from STDIN and write to STDOUT. very demure, very pipe-friendly. 🌈 you may also wanna use the --name option to name the test explicitly — because the default name of - is... not going to make much sense, bestie. it's literally just a dash. do with that what you will. 😭

✨ OPTIONS ✨

  • --suffix <suffix> — tells it what suffix to staple onto all the input files, so it can generate the filename for the JUnit XML file it's about to output. ✍️
⚠️ okay so if you want to live dangerously and over-write your original TAP files, you can set this to "" and your original TAP files will be over-written. that's not a drill, that's a genuine "no take-backs" situation. 💀

defaults to .xml. 🌸

  • --verbose — shows you verbose status information while the conversion is happening, i.e. it tells you which TAP file it's currently working on. very "narrating my own life" of it. 🎀
  • --name <name> — gives the JUnit test an explicit name. if you don't provide one, a default name gets constructed based on the full path of the TAP file being processed. 🦋

this option has also been aliased as --junit_name to provide compatibility with a patch from Joe McMahon. shoutout Joe. 🙌

  • --help/-? — display brief help message. short and sweet. ✨
  • --man — displays the full documentation. (yes, the thing you're reading right now. meta.) 📖

🌈 AUTHOR 🌈

Graham TerMarsch <cpan@howlingfrog.com> 💖

Copyright 2008-2010, Graham TerMarsch. All Rights Reserved.

This is free software; you can redistribute it and/or modify it under the same terms as Perl itself. slay, honestly. 👑

🧚 SEE ALSO 🧚

TAP::Formatter::JUnit — go read that one next, bestie, it's the sequel. 💜

and that's the whole page!! this manual was served to you by perl v5.40.0, dated 2025-02-07, and yes i know the original header and footer lived on those exact lines — but we folded them in here instead, so consider this the cutest possible sign-off: mwah 💅✨ go convert some TAP, you got this 🫶

📦 where this page comes from