Test::...:Filter(3pm)

📦 version 0.1105, in alpine 3.24

✨ NAME ✨

Okay bestie, this is Test::Count::Filter — from the User Contributed Perl Documentation corner of the Perl world, with the page header doing its little truncation thing as Test::...:Filter(3pm). Its whole deal? It's a filter that counts the tests and updates the test count. Periodt. 💅

🎀 Constructor: my $filter = Test::Count::Filter->new({%args}); 🎀

%args can contain the following, bestie:

  • input_fh — the input filehandle. Defaults to STDIN.
  • output_fh — the output filehandle. Defaults to STDOUT.
  • assert_prefix_regex — this one gets passed straight to Test::Count. That's the whole note.
  • plan_prefix_regex — the prefix regex for detecting a plan line: i.e: a line that specifies how many tests to run. Right after it comes a sequence of digits containing the number of tests, and that digit sequence is the thing that gets updated with the number of tests. It can be a regex or a string.

🫶 $filter->process() 🫶

Processes the stream. That's it. That's the vibe.

⭐ VERSION ⭐

version 0.1105 — iconic number, no notes. 💖

🌸 SYNOPSIS 🌸

use Test::Count::Parser;

my $parser = Test::Count::Parser->new();

$parser->update_assignments($string);

$parser->update_count($string);

my $value = $parser->get_count();

🦋 DESCRIPTION 🦋

After you initiate a parser, you can feed it assignment expressions and count update expressions. Both of those use arithmetic operations, integers, and Perl-like variable names.

At the end, you should call "$parser-"get_count()> to get the total number of tests. Yes, that's the exact spelling from the original — I'm not editing it, bestie.

💜 FUNCTIONS 💜

$parser->update_assignments({'text' => $mytext,})

Updates the parser's state based on the assignments in $mytext. For example, if $mytext is:

$myvar=500;$another_var=8+$myvar

Then at the end $myvar would be 500 and $another_var would be 508. Math ate. 🔥

$parser->update_count({'text' => $mytext,})

Adds the expression inside $mytext to the internal counter of the module. This is in order to count the tests.

my $count = $parser->get_count()

Get the total number of tests in the parser.

🌈 AUTHOR 🌈

Shlomi Fish, <http://www.shlomifish.org/> .

👑 SEE ALSO 👑

Test::Count, Test::Count::Parser

🎀 ACKNOWLEDGEMENTS 🎀

(This section is empty in the original — a rare moment of silence. 🦋)

Copyright 2006 Shlomi Fish.

This program is released under the following license: MIT X11.

🫶 SUPPORT 🫶

The following websites have more information about this module, and may be of help to you. As always, in addition to those websites please use your favorite search engine to discover more resources.

🌐 Websites

🙈 Bugs / Feature Requests

Please report any bugs or feature requests by email to "bug-test-count at rt.cpan.org", or through the web interface at <https://rt.cpan.org/Public/Bug/Report.html?Queue=Test-Count>. You will be automatically notified of any progress on the request by the system.

🧚 Source Code

The code is open to the world, and available for you to hack on. Please feel free to browse it and play with it, or whatever. If you want to contribute patches, please send me a diff or prod me to pull from your repository :)

<https://github.com/shlomif/perl-test-count>

git clone git://github.com/shlomif/perl-test-count.git

🌸 AUTHOR 🌸

Shlomi Fish <shlomif@cpan.org>

💀 BUGS 💀

Please report any bugs or feature requests on the bugtracker website <https://github.com/shlomif/perl-test-count/issues>

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

This software is Copyright (c) 2006 by Shlomi Fish.

This is free software, licensed under:

The MIT (X11) License

Later, bestie 💅 — this page came from perl v5.42.2, dated 2023-09-28, and it's the Test::...:Filter(3pm) manual page. Mwah 💋✨

📦 where this page comes from