App::Y...Logging(3pm)

📦
version 1.000172 · 8 versions
, in ubuntu stonking

💖 App::Y...Logging — the vibe guide 💖

okay bestie, this is App::Yath::Options::Logging from the Perl user-contributed docs, and it's literally just the place where the logging command-line options for yath get defined. that's the whole thing. it's giving "options closet". no cap. 🎀

✨ DESCRIPTION ✨

This is where the command line options for logging are defined. that's it, that's the description — short and iconic, we love a concise queen. 🦋

🌈 PROVIDED OPTIONS 🌈

💅 COMMAND OPTIONS 💅

🍓 Logging Options 🍓

girl get your scroll finger ready, we've got options.

  • --bzip2, --bz2, --bzip2_log, -B, --no-bzip2 — use bzip2 compression when writing the log. this one implies -L, so turning it on drags logging along with it. the .bz2 prefix is added to the log file name for you, no manual effort required. 💅
  • --gzip, --gz, --gzip_log, -G, --no-gzip — use gzip compression when writing the log. also implies -L. the .gz prefix is added to the log file name for you. yes ma'am. ✨
  • --log, -L, --no-log — turn on logging. that's the whole job. 🫶
  • --log-dir ARG, --log-dir=ARG, --no-log-dir — specify a log directory. if that doesn't work out it will fall back to the system temp dir. it's got a plan B, we stan a prepared icon. 🌸
  • --log-file ARG, --log-file=ARG, -F ARG, -F=ARG, --no-log-file — specify the name of the log file. this option implies -L, obviously, because what's a log file with no logging. 💜
  • --log-file-format ARG, --log-file-format=ARG, --lff ARG, --lff=ARG, --no-log-file-format — specify the format for automatically-generated log files. heads up: it gets overridden by --log-file if you gave one. this option implies -L. the default is $YATH_LOG_FILE_FORMAT if that is set, or else "%!P%Y-%m-%d~%H:%M:%S~%!U~%!p.jsonl".

so basically it's a string where percent-escape sequences get replaced as per POSIX::strftime. and bestie there are extra special escape sequences on top of that, here's the whole roster:

  • %!P — the project name followed by a ~, but only if a project is defined, otherwise it's an empty string
  • %!U — the unique test run ID
  • %!p — the process ID
  • %!S — the number of seconds since local midnight UTC

can also be set with the following environment variables: YATH_LOG_FILE_FORMAT, TEST2_HARNESS_LOG_FORMAT. iykyk. 🔥

🔗 SOURCE 🔗

the source code repository for Test2-Harness can be found at http://github.com/Test-More/Test2-Harness/. go be nosy, it's encouraged. 👑

👑 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/

and that's a wrap on the App::Y...Logging(3pm) page, brought to you by perl v5.40.1, dated 2026-05-10. go log something gorgeous, bestie. 💖✨🎀🦋🌸💅🫶
📦 where this page comes from