App::Y...ns::Run(3pm)

📦
version 1.000172 · 8 versions
, in ubuntu stonking

💖 App::Yath::Options::Run 💖

okay so bestie, real talk: this page is App::Yath::Options::Run(3pm), and it's literally just the corner of yath where all the command line options for a single test run get defined. like, one module. for the run options. it's giving organized 👑

🌸 NAME 🌸

App::Yath::Options::Run — run options for Yath. that's the whole name, no notes, periodt.

✨ DESCRIPTION ✨

This is where command lines options for a single test run are defined. that's it, that's the vibe — this file is the master list of every knob you can twist for one run. 🎀

👑 PROVIDED OPTIONS 👑

🛠️ COMMAND OPTIONS

🫶 Run Options

  • --author-testing, -A, --no-author-testing — sets the AUTHOR_TESTING environment variable to true. that's it. that's the whole thing. 💅
  • --dbi-profiling, --no-dbi-profiling — pulls in Test2::Plugin::DBIProfile so you can collect database profiling data. watching your DB sweat? iconic. 🔥
  • --env-var VAR=VAL, -EVAR=VAL, -E VAR=VAL, --no-env-var — sets environment variables that get set when each test is run.

Can be specified multiple times, bestie — stack 'em up. ✨

  • --event-uuids, --uuids, --no-event-uuids — uses Test2::Plugin::UUID inside tests (default: on). yeah it's already on, it was on before you got here. 🌟
  • --fields name:details, --fields JSON_STRING, -f name:details, -f JSON_STRING, --no-fields — adds custom data to the harness run.

Can be specified multiple times. ✨

  • --input ARG, --input=ARG, --no-input — an input string that gets used as standard input for ALL tests. see also: --input-file. all caps ALL, because it's every single one. 😭
  • --input-file ARG, --input-file=ARG, --no-input-file — uses the specified file as standard input to ALL tests. again: ALL of them. 🍓
  • --io-events, --no-io-events — uses Test2::Plugin::IOEvents inside tests to turn all prints into test2 events (default: off). ✨
  • --link 'https://travis.work/builds/42', --link 'https://jenkins.work/job/42', --link 'https://buildbot.work/builders/foo/builds/42', --no-link — hands people one or more links they can follow to see more about this run. very "here's the receipts" of you. 🫶

Can be specified multiple times.

  • --load ARG, --load=ARG, --load-module ARG, --load-module=ARG, -m ARG, -m=ARG, --no-load — loads a module in each test (after fork). heads up: the import method is not called. 💀

Can be specified multiple times.

  • --load-import Module, --load-import Module=import_arg1,arg2,..., --loadim Module, --loadim Module=import_arg1,arg2,..., -M Module, -M Module=import_arg1,arg2,..., --no-load-import — loads a module in each test (after fork). and this time, Import is called. 👑

Can be specified multiple times. If the same key is listed multiple times the value lists will be appended together. (yes, appended. the lists get merged, not replaced. no cap. 🧚)

  • --mem-usage, --no-mem-usage — uses Test2::Plugin::MemUsage inside tests (default: on). 🌈
  • --retry ARG, --retry=ARG, -r ARG, -r=ARG, --no-retry — runs any jobs that failed a second time. NOTE: --retry=1 means failing tests will be attempted twice! read that again bestie, it's not "one retry", it's "run it again", so a total of two attempts. 🙈
  • --retry-isolated, --retry-iso, --no-retry-isolated — if true then any job retries will be done in isolation (as though -j1 was set). just retries, alone, vibing. 🦋
  • --run-id, --id, --no-run-id — sets a specific run-id. (Default: a UUID). yes you can override the UUID, you chaotic icon. ✨
  • --test-args ARG, --test-args=ARG, --no-test-args — arguments to pass in as @ARGV for all tests that are run. these can be provided easier using the '::' argument separator. (fr fr, use the separator.)

Can be specified multiple times.

  • --stream, --no-stream — uses the stream formatter (default is on). 🌟
  • --tap, --TAP, ----no-stream, --no-tap — okay so. the TAP format is lossy and clunky. 🫠 Test2::Harness normally uses a newer streaming format to receive test results. there are old/legacy tests where this causes problems, in which case setting --TAP or --no-stream can help. that's the fix, that's the escape hatch. (and yes, ----no-stream really does have four dashes, we don't make the rules 💅)

📚 SOURCE 📚

The source code repository for Test2-Harness can be found at http://github.com/Test-More/Test2-Harness/. go look, it's right there. 🎀

💜 MAINTAINERS 💜

Chad Granum <exodist@cpan.org>

🌸 AUTHORS 🌸

Chad Granum <exodist@cpan.org>

Copyright 2020 Chad Granum <exodist7@gmail.com>.

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

See http://dev.perl.org/licenses/

okay that's the whole page, every single option, every default, every "can be specified multiple times", nothing skipped, nothing invented. 💖

and that's a wrap bestie — this page came to you courtesy of perl v5.40.1, dated 2026-05-10, and it is App::Yath::Options::Run(3pm) through and through. slay, go run some tests. 👑✨🫶

📦 where this page comes from