Catman...Modules(3pm)

✨ NAME ✨

Catmandu::Importer::Modules — the little icon that lists all your installed perl modules inside a namespace 🫶

(also, hi, this is a 3pm page, so it's perl module documentation, and the title up top is Catman...Modules(3pm) — the man page name got truncated for display but bestie, you know who she is 💅)

---

🌸 DESCRIPTION 🌸

Okay so. This is a Catmandu::Importer, and what it does is literally walk all your perl library paths and hand you back every perl module it finds — and for each one it gives you the whole glow-up package:

• name
• version
• absolute file
• library path
• and a short description, aka the about

No cap, it's giving "who's installed on this machine and where are they hiding" 🕵️‍♀️✨

---

🎀 CONFIGURATION 🎀

Every knob you can turn, in order, no skips:

• file — read input from a local file, you just hand it the path. Orrrrr you can pass a scalar reference and it'll read from a string instead. versatile queen 💖
• fh — read input from an IO::Handle. If you don't set this one, Catmandu::Util::io is used to build the input stream — either from the file argument or from STDIN.
• encoding — the binmode of the input stream fh. Defaults to :utf8. ✨
• fix — an ARRAY of one or more fixes or file scripts that get applied to the imported items. your little makeover station 💅
• namespace — the namespace(s) you want modules listed for. Give it an array, or a comma-separated list. you do you 🦋
• inc — the list of library paths. defaults to @INC.
• max_depth — the maximum depth to recurse into the namespace. fr fr, here's how it works: if the namespace is Catmandu::Fix, then Catmandu::Fix::add_field has a depth of 1, and Catmandu::Fix::Condition::exists has a depth of 2. math is math 📐
• pattern — filter modules by the given regex pattern. 🔍
• primary — filter modules down to just the first module of each name. one per name, no duplicates, main character only 👑
• about — include the short description as given in the NAME section of each module's documentation. Enabled by default. so it's on unless you say otherwise 🫶

---

🧚 METHODS 🧚

Every Catmandu::Importer is a Catmandu::Iterable, and all its methods are inherited. so like… all that iterable energy is yours, you didn't have to lift a finger 💜

---

💜 SEE ALSO 💜

• Catmandu::Importer::CPAN
• Catmandu::Cmd::info

---

okay that's the whole page bestie, go forth and import some modules 🌈⭐

stay slay, this was perl v5.40.1, dated 2026-01-24, and the page lives under Catman...Modules(3pm) — mwah 💋🎀