TAP2JUNIT(1)

📦
version 0.17 · 2 versions
, in fedora 43

💅 NAME

okay so bestie, gather round — tap2junit is literally the glow-up machine that Converts TAP output to JUnit ✨ it takes your TAP and gives it a whole new main-character outfit, no cap.

✨ 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, that's it. that's the whole vibe. you hand it files, it hands you JUnit 🎀

🦋 DESCRIPTION

tap2junit converts TAP output to JUnit. fr fr, that's the entire personality.

so here's the tea: you give it a whole list of files that are full of TAP results, and it will create a series of ????.junit.xml output files containing the JUnit representations of that TAP contained in the files. it's giving translator energy 💖

and okay, plot twist — if you specify - as the filename, tap2junit will read from STDIN and write to STDOUT. iconic. but like… you probably also wanna use the --name option to name the test explicitly, because the default name of - isn't going to make much sense. it's lowkey embarrassing honestly 😭

👑 OPTIONS

  • --suffix <suffix> — Specifies the suffix which is appended to all of the input files, in order to generate the filename for the JUnit XML file that is being output.
⚠️ okay so listen. 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 bestie, that's your files GONE. proceed with caution 💀

Defaults to .xml

  • --verbose — Display verbose status information during the conversion (telling you which TAP file its working on). so you're not just sitting there like 🙈 wondering if it's stuck.
  • --name <name> — Specifies an explicit name for the JUnit test. If no name is provided, a default name will be 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. the lil quickie.
  • --man — Displays the full documentation. the full meal, the whole menu, the extended cut 🌸

🌈 AUTHOR

Graham TerMarsch <cpan@howlingfrog.com> — yes, that's the icon, that's the legend, that's who made this whole thing happen 👑

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. so like, go off, remix it, share it, it's free real estate 💖

🧚 SEE ALSO

TAP::Formatter::JUnit.

and that's the whole page bestie!! this was TAP2JUNIT(1), from the User Contributed Perl Documentation, brought to you by perl v5.42.0, dated 2025-07-25. mwah 💅✨

📦 where this page comes from