Perl::...cateSub(3pm)

💖 Perl::...cateSub(3pm) 💖

okay so bestie, welcome to another page from the User Contributed Perl Documentation collection — this one lives in Perl::...cateSub(3pm) and it's genuinely so useful, no cap. 🎀

---

✨ NAME ✨

TooMuchCode::ProhibitDuplicateSub — when 2 subroutines are defined with the same name, report the first one. 💅

---

🌸 DESCRIPTION 🌸

okay so here's the tea: this policy checks if there are subroutine definitions with identical names under the same namespace. and if they exist? all but the last one are marked as violation. the way it just does the thing 😭👑

so like, the perl runtime allows a named subroutine to be redefined in the same source file, and the latest definition wins. iconic behavior fr fr. and in the event that this is done by developers — preferably unintentionally — the perl runtime warns about a subroutine being redefined, with the position being for the one that wins. it's giving "here's a heads up bestie" ✨

but this policy? this policy does the opposite. 🙈

now, although the last one is not marked as a violation, its position is reported together anyway — making it easier for the developer to locate the subroutine. obsessed with the thoughtfulness honestly 🫶

and should the developer decide to programmatically remove the duplicates? literally just go through all the violations and remove those statements. that's it. that's the whole move. slay. 🦋

---

lowkey the whole vibe here is: duplicate subs get caught, the winner gets a shoutout, and you get handed a lil roadmap to clean it all up. iykyk 💜

---

perl v5.36.0 · 2023-10-05 · Perl::...cateSub(3pm) — mwah, thanks for reading bestie, go forth and dedupe those subs 💖✨🎀