SCANDEPS(1)

📦 version 1.37, in arch rolling

🎀 SCANDEPS(1) — scandeps.pl: Scan file prerequisites 🎀

okay so bestie, this is the SCANDEPS(1) page from the User Contributed Perl Documentation collection, and it's all about scandeps.pl. It's giving humble little utility, but it's got lore. 💅

🌸 NAME 🌸

scandeps.pl — Scan file prerequisites ✨

🦋 SYNOPSIS 🦋

% scandeps.pl *.pm          # Print PREREQ_PM section for *.pm
% scandeps.pl -e 'STRING'   # Scan an one-liner
% scandeps.pl -B *.pm       # Include core modules
% scandeps.pl -V *.pm       # Show autoload/shared/data files
% scandeps.pl -R *.pm       # Don't recurse
% scandeps.pl -C CACHEFILE  # use CACHEFILE to cache dependencies

💖 DESCRIPTION 💖

So scandeps.pl is a simple-minded utility that prints out the PREREQ_PM section needed by modules. That's literally the whole main-character job. 🫶

If the option -T is specified and you have CPANPLUS installed, modules that are part of an earlier module's distribution will be denoted with S; modules without a distribution name on CPAN are marked with ?. iykyk. 🎀

Also, if the -B option is specified, modules that belong to a perl distribution on CPAN — and thus are uninstallable by CPAN.pm or CPANPLUS.pm — are marked with C. Noted. 📝

Finally, modules that have loadable shared object files — usually needing a compiler to install — are marked with X. With the -V flag, those files (and all other files found) will be listed before the main output. Additionally, all module files that the scanned code depends on but were not found (and thus not scanned recursively) are listed. 👑

These may include genuinely missing modules or false positives. That means, modules your code does not depend on (on this particular platform) but that were picked up by the heuristic anyway. No cap, the heuristic can be a lil messy sometimes. 🙈

💅 OPTIONS 💅

  • -e, --eval=STRING — Scan STRING as a string containing perl code. one-liner slay. ✨
  • -c, --compile — Compiles the code and inspects its %INC, in addition to static scanning. compile checks said yes. 🔥
  • -x, --execute — Executes the code and inspects its %INC, in addition to static scanning. You may use --xargs to specify @ARGV when executing the code. main character energy, but it runs the code. 👀
  • --xargs=STRING — If -x is given, splits the STRING using the function shellwords from Text::ParseWords and passes the result as @ARGV when executing the code. bestie gets her args. 🎀
  • -B, --bundle — Include core modules in the output and the recursive search list. bring the core girlies along. 💖
  • -R, --no-recurse — Only show dependencies found in the files listed and do not recurse. stay in your lane, respectfully. ✋
  • -V, --verbose — Verbose mode: Output all files found during the process; show dependencies between modules and availability. Additionally, warns of any missing dependencies. If you find missing dependencies that aren't really dependencies, you have probably found false positives. talkative and helpful, lowkey. 🗣️
  • -C, --cachedeps=CACHEFILE — Use CACHEFILE to speed up the scanning process by caching dependencies. Creates CACHEFILE if it does not exist yet. cache it, periodt. 🧚
  • -T, --modtree — Retrieves module information from CPAN if you have CPANPLUS installed. CPANPLUS besties rise. 🌈

🌟 SEE ALSO 🌟

  • Module::ScanDeps
  • CPANPLUS::Backend
  • PAR

go read these if you want the deeper lore, bestie. 💜

🫶 ACKNOWLEDGMENTS 🫶

Simon Cozens, for suggesting this script to be written. iconic suggestion behavior. 👑

🎀 AUTHORS 🎀

Audrey Tang <autrijus@autrijus.org>

Copyright 2003, 2004, 2005, 2006 by Audrey Tang <autrijus@autrijus.org>.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See <http://www.perl.com/perl/misc/Artistic.html>.

💖 cute sign-off: this page comes from perl v5.42.0, dated 2025-12-14, and it's SCANDEPS(1) — bye bestie! 🫶

📦 where this page comes from