Perl::...rnation(3pm)

📦
version 1.156.0 · 12 versions
, in opensuse-leap 16.0

💅 NAME 💅

Bestie, welcome to Perl::Critic::Policy::RegularExpressions::ProhibitSingleCharAlternation — a whole policy whose entire vibe is: use [abc] instead of a|b|c. That's it. That's the girl. ✨

(This page ships as part of the Perl::...rnation(3pm) manual — yes, the name got ate by the truncation goblins, it's fine, we move. 🎀)

🫶 AFFILIATION 🫶

So this policy is core — it's part of the standard Perl::Critic distribution. No add-on shopping trip required, she's already in the bag. 💖

🌸 DESCRIPTION 🌸

Okay so listen. Character classes — the ones that look like [abc] — are significantly faster than single character alternations like (?:a|b|c). Not a little faster. Significantly. She's got main character energy and the alternation is lowkey struggling in the background. 😭

So what does this policy actually do? It complains — loudly — if you've got more than one instance of a single character inside an alternation. One is fine, two or more and she's in your mentions.

Which means:

  • (?:a|the) — ✅ allowed, no notes, we love her
  • (?:a|e|i|o|u) — ❌ not allowed, bestie, that's literally what [aeiou] is for, iykyk

Periodt. 🌈

⭐ CONFIGURATION ⭐

Not configurable, bestie. Nothing to tweak. Nada. 💀

The only knobs you get are the standard options — the universal ones every policy has. That's it. She's low maintenance like that. 🦋

👑 CREDITS 👑

The initial development of this policy was supported by a grant from the Perl Foundation. Shoutout to them, fr fr, absolute icons for funding this one. 🙏🌸

🧚 AUTHOR 🧚

Chris Dolan <cdolan@cpan.org> — thank you for your service, king. 🫶

Copyright (c) 2007-2023 Chris Dolan

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. The full text of this license can be found in the LICENSE file included with this module.

Ngl that's the legal stuff, keep it intact, don't let anyone tell you otherwise. 💅

Sign-off szn: this little love letter comes to you on perl v5.42.0, dated 2024-10-23. Slay, stay caffeinated, and go convert your alternations to character classes. Mwah. 💖✨🎀

📦 where this page comes from