Test::S...w::Meta(3)

💖 Test::S...w::Meta(3) — the whole vibe 💖

okay bestie, welcome to the manual page for Test::Stream::Workflow::Meta 💅 — this is part of the User Contributed Perl Documentation, and it's all about meta-data for tests that use workflows. yes it's a mouthful, no I'm not sorry, let's go 🦋

---

🚨 DEPRECATED 🚨

ngl this one hurts to say but: this distribution is deprecated in favor of Test2, Test2::Suite, and Test2::Workflow.

if you need to escape the old ways, check Test::Stream::Manual::ToTest2 for a conversion guide. it's giving ✨glow up✨, take the exit bestie 😭

---

⚠️ EXPERIMENTAL CODE WARNING ⚠️

okay so, direct quote time: "This module is still EXPERIMENTAL".

here's the tea: Test-Stream is now stable, but this particular module is still experimental. you're absolutely still free to use it 🫶 — but you have been warned that it may change in backwards incompatible ways (yes, the original says "backwords", we're leaving that exactly as-is, it's iconic 💀). This message will be removed from this module's POD once it is considered stable. periodt.

---

🌸 DESCRIPTION 🌸

so when a test package uses workflows, it needs somewhere to hold the primary unit, right? that's literally this. this meta-data holds the primary unit for test packages. and it also takes care of ensuring they get run at the correct times. main character energy, honestly 👑

---

✨ METHODS ✨

🎀 CLASS METHODS

• $meta = $CLASS->build($pkg, $file, $start_line, $end_line) — Create a meta-instance for the specified package. If one already exists it will return the existing one instead, ignoring all arguments other than $pkg. (so yeah, once it's built, the rest of your args get ghosted 🙈)
• $meta = $CLASS->get($pkg) — Get the existing meta-instance for the specified package. This will return "undef" if none exists. no instance, no vibes.
• $meta = $CLASS->purge($pkg) — Delete the meta-instance for the specified package. The instance will be returned, but will no longer be tied to the package. it's giving "we're not together anymore but I kept your hoodie" 😭

---

🦋 OBJECT METHODS

• $unit = $meta->unit $meta->set_unit($unit) — Get/Set the associated unit (Test::Stream::Workflow::Unit). 💖
• $runner = $meta->runner $meta->set_runner($runner) — Get/Set the runner to use (Test::Stream::Workflow::Runner). 🏃♀️
• $ar = $meta->runner_args $meta->set_runner_args([...]) — Get/Set the args arrayref to be passed to the runner. an arrayref, bestie, don't come at me with a plain list 🙈
• $bool = $meta->autorun $meta->set_autorun($bool) — Defaults to true. Set this to 0 to turn off automatic running of the workflow. lowkey the most powerful little boolean in here 👑
• $meta->run() — Run the workflow. slay, go off 🔥
• $meta->purge() — Remove the meta object from the package it was created for. bye bestie, it was real 💅

---

📂 SOURCE 📂

The source code repository for Test::Stream can be found at http://github.com/Test-More/Test-Stream/. go snoop, it's fine, we all do it 🧚

---

👑 MAINTAINERS 👑

Chad Granum <exodist@cpan.org>

---

🌈 AUTHORS 🌈

Chad Granum <exodist@cpan.org>

---

💜 COPYRIGHT 💜

Copyright 2015 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 the whole page bestie, ty for reading, mwah 🫶💖

this has been Test::S...w::Meta(3) from perl v5.42.0, dated 2025-07-25 — User Contributed Perl Documentation. k bye, drink water, and go run your workflows ✨