TANGERINE(1)

💅 TANGERINE 💅

okay bestie, so this is tangerine — a Perl dependency metadata tool ✨ it lives in the User Contributed Perl Documentation section of the manual (section 1, she's a command, she's a whole command 🫶).

---

✨ SYNOPSIS ✨

tangerine [options] <files or directories>

like. that's it. that's the whole vibe. you point her at stuff, she tells you things 💖

---

🌸 DESCRIPTION 🌸

so this utility literally attempts to examine and analyze perl files, directories or perl distribution archives — and then she reports the provided modules, plus the compile-time and run-time dependencies. no cap, she's doing the most so you don't have to 🙈

and then there's diff mode, where she reports the differences between two directories or perl distribution archives. it's giving "spot the difference but make it metadata" 👑

---

🎀 OPTIONS 🎀

• --all, -a — examine all recursively discovered files. by default tho? only perl files are considered. so this is her "expand the vibe check to everyone" button 💅
• --compact, -c — do not list dependencies that are provided by the examined set. she's keeping it tight, she's keeping it minimal ✂️
• --diff, -d FOO BAR — examine FOO and BAR and report the metadata differences, ignoring line numbers. these can be directories or distribution tarballs, no judgement 🍓
• --files, -f — report findings per file instead of per module. heads up tho: this option has no effect with --compact 😭
• --jobs, -j NUM — defines the number of workers used for parallel processing 🧚 by default, the optimal number of workers is determined automatically. she's self-sufficient like that, main character energy fr fr
• --help, -h — display this help 🫶
• --mode, -m MODE — only look for this specific metadata. valid options are:
  • compile — modules required at compile time
  • runtime — modules required at runtime
  • package — modules provided
  • all

and for backwards compatibility, p|prov, r|req and u|use are also understood 👑 note that this option is automatically set to all if --compact is also used. defaults to all ✨

• --verbose, -v — be a little more verbose where it makes sense 🗣️ (she's not gonna yap for no reason, she has standards)

---

🌈 EXAMPLES 🌈

tangerine -c Makefile.PL lib/ t/
tangerine --mode=compile inc/
tangerine -d Foo-0.01.tar.gz Foo-0.02.tar.gz

look at her go. iconic. ate. no crumbs 💜

---

💖 AUTHOR AND LICENSE 💖

Copyright (c) 2014-2015 Petr Šabata <contyk@redhat.com>

See the LICENSE files for licensing details 📜

---

and that's the whole page bestie!! this version of the docs is from perl v5.42.0, dated 2025-07-25 — so when you're out here reading it, that's the era you're in 🦋 stay slay, go analyze some perl, periodt 💅✨🎀