Perl::Critic::Policy::ValuesAndExpressions::ProhibitLongChainsOfMethodCalls(3pm)

Perl::Critic::Policy::ValuesAndExpressions::ProhibitLongChainsOfMethodCalls3pm

Long chains of method calls indicate tightly coupled code.

Affiliation

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

Overview

A long chain of method calls usually indicates that the code knows too much about the interrelationships between objects. If the code is able to directly navigate far down a network of objects, then when the network changes structure in the future, the code will need to be modified to deal with the change. The code is too tightly coupled and is brittle.

    $x = $y->a;           #ok
    $x = $y->a->b;        #ok
    $x = $y->a->b->c;     #questionable, but allowed by default
    $x = $y->a->b->c->d;  #not ok

Configuration

This policy has one option: "max_chain_length" which controls how far the code is allowed to navigate. The default value is 3.

To do

Add a "class_method_exemptions" option to allow for things like

    File::Find::Rule
        ->name('*.blah')
        ->not_name('thingy')
        ->readable()
        ->directory()
        ->in(@roots);

Releases

10 releases since Debian 5.0 (Lenny); the text changed 9 times.

  1. 5.0
  2. 6.0
  3. 7
  4. 8
  5. 9
  6. 10
  7. 11
  8. 12
  9. 13
  10. Arch

Author

Elliot Shank "<[email protected]>"

From perl-perl-critic 1.156-3 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.