Perl::...pNests(3pm)

okay bestie, welcome to this User Contributed Perl Documentation page β€” it’s the 3pm manual for Perl::Critic::Policy::ControlStructures::ProhibitDeepNests (the header labels it Perl::...pNests(3pm)), and it is literally here to tell you: don’t write deeply nested loops and conditionals πŸ’…βœ¨

πŸŽ€ NAME πŸŽ€

  • Perl::Critic::Policy::ControlStructures::ProhibitDeepNests β€” Don’t write deeply nested loops and conditionals. periodt.

🌸 AFFILIATION 🌸

This Policy is part of the core Perl::Critic distribution. core fam 🫢

πŸ¦‹ DESCRIPTION πŸ¦‹

Deeply nested code is often hard to understand and may be a sign that it needs to be refactored. no cap, your future self will thank you 😭

There are several good books on how to refactor code. The author says I like Martin Fowler’s "Refactoring: Improving The Design of Existing Code". iconic pick tbh πŸ“š

✨ CONFIGURATION ✨

The maximum number of nested control structures can be configured via a value for max_nests in a .perlcriticrc file.

Each for-loop, if-else, while, and until block is counted as one nest. Postfix forms of these constructs are not counted. The default maximum is 5.

Customization in a .perlcriticrc file looks like this:

[ControlStructures::ProhibitDeepNests]
max_nests = 3

slay, now you can set your own vibe check on nesting depth πŸ’–

πŸ‘‘ AUTHOR πŸ‘‘

Jeffrey Ryan Thalhammer <jeff@imaginative-software.com> wrote this one. icon behavior.

Copyright (c) 2005-2011 Imaginative Software Systems. All rights reserved.

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.


that’s the whole page, bestie β€” from perl v5.42.0, dated 2024-10-23 πŸ«ΆπŸ’–βœ¨

πŸ“¦ where this page comes from