Perl::...tBlock(3pm)

💅 NAME 💅

ok so bestie, this page is Perl::Critic::Policy::BuiltinFunctions::RequireSimpleSortBlock — and the whole vibe is: sort blocks should have a single statement. that's it. that's the rule. periodt. ✨

---

🎀 AFFILIATION 🎀

This Policy is part of the core Perl::Critic distribution. so like, it ships with the whole thing, no extra install drama, you're welcome 🫶

---

🌸 DESCRIPTION 🌸

So Conway — yes, that Conway, the one whose book everybody keeps telling you to read — advises that sort functions should be simple. like, lowkey keep it cute in there.

Here's the tea ☕: any complicated operations on list elements should be computed and cached (perhaps via a Schwartzian Transform) before the sort, rather than computed inside the sort block. Why? because the sort block gets called "N log N" times instead of just "N" times. that's a whole lotta extra work for no reason, and honestly? not the move. 💀

This policy prohibits the most blatant case of complicated sort blocks: multiple statements. that's the icon of bad behavior it's coming for. 🚨

Future policies may wish to examine the sort block in more detail — looking for subroutine calls or large numbers of operations. so like, this one's just the opening act, iykyk 👀

---

✨ CONFIGURATION ✨

This Policy is not configurable except for the standard options. no knobs to fiddle with, no settings to tweak — she is what she is, and she ate 💅

---

👑 AUTHOR 👑

Chris Dolan <cdolan@cpan.org> — legend behavior, we stan 🫶

---

🌈 COPYRIGHT 🌈

Copyright (c) 2006-2011 Chris Dolan.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. slay, permissive licensing, we love to see it 💖

---

okay bestie that's the whole page 💜 this was Perl::...tBlock(3pm) from the User Contributed Perl Documentation, generated with perl v5.42.0, dated 2024-10-23. go forth and keep your sort blocks to one statement, no cap 🌸🎀🦋