MODULES-USED(1)

📦
version 1.3.0 · 2 versions
, in fedora 43

💖 MODULES-USED 💖 (that's the modules-used man page from the User Contributed Perl Documentation section, bestie)

okay so listen. imagine you wanna know which modules some Perl code is pulling in, but you do NOT wanna actually run that code. sketchy? maybe. relatable? absolutely. that's literally what this lil icon does.

✨ NAME ✨

modules-used — list all the modules that a set of Perl source files uses, and do it without ever running them. no cap. 💅

🌸 VERSION 🌸

this doc is describing modules-used version 1.3.0. periodt.

🎀 USAGE 🎀

modules-used source-file [...]

🦋 DESCRIPTION 🦋

so basically it dumps out a list of every module your Perl code uses. how does it know? it finds them statically, by looking at your use and require statements. no execution, no running, just vibes and reading. 👑

and here's the cute part: if it spots a base or parent being used, it will emit both that module and the ones it references. the way that it just knows?? obsessed.

⚠️ but bestie, listen — dynamically loaded modules will not be found. at all. if your code does some runtime require shenanigans, this tool is gonna be like "i don't see it 🤷" so don't come for it.

🌈 REQUIRED ARGUMENTS 🌈

  • source-file [...] — a whole list of files you want it to search through. give it the files, it does the thing. 🫶

💜 OPTIONS 💜

None. nope, zero, nada, not a single flag. it's giving minimalism. it's giving "i don't need options to slay". 🧚

💀 DIAGNOSTICS 💀

here's where it tells you what went wrong, and honestly? same.

  • Could not find module "%s" in @INC. — it can't find where the named module lives. and just to be super clear: this program will not find any dynamically loaded modules. not a one. 🙈
  • "%s" does not exist. — the file? not there. doesn't exist. gone. vanished.
  • "%s" is not readable. — it's there but you can't read it. rude of it, honestly.
  • "%s" is a directory. — plot twist: the "file" was actually a directory the whole time. main character twist energy. 😭
  • Could not parse "%s". — PPI looked at the file and was like "bestie this is not a Perl document". it could not interpret it. 💀

🍓 CONFIGURATION AND ENVIRONMENT 🍓

None. no config, no env vars, nothing to set up. it just works. ✨

⭐ DEPENDENCIES ⭐

  • Module::Used

that's the one. that's the whole list. iykyk.

🌸 INCOMPATIBILITIES 🌸

None known. she plays nice with everybody. 🎀

💅 BUGS AND LIMITATIONS 💅

None reported. (iconic behaviour, honestly)

but fr fr, if you do find bugs or have feature requests, please report them to bug-module-used@rt.cpan.org, or through the web interface at <http://rt.cpan.org>. don't just suffer in silence, bestie. 🫶

🔥 SEE ALSO 🔥

  • Devel::Loaded
  • Module::Extract::Namespaces
  • Module::ScanDeps
  • Module::PrintUsed

go check 'em out, they're all part of the same little friend group. 💖

👑 AUTHOR 👑

Elliot Shank <perl@galumph.com>

Copyright ©2008-2012, Elliot Shank <perl@galumph.com>.

this module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. see perlartistic. so like, go forth and remix, just keep it legal. 💜

⚠️ DISCLAIMER OF WARRANTY ⚠️

okay bestie this part is all caps for a REASON so pay attention:

BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENSE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

like, no refunds on free software, that's the deal. 🫶

and that's the whole page, bestie!! 💖 this one came to you from perl v5.42.0, dated 2025-07-25, and it's the MODULES-USED(1) page from the User Contributed Perl Documentation section. stay slaying, stay statically analyzing, and may your @INC always be findable. mwah 💅✨

📦 where this page comes from