Rollen und die Lesbarkeit des Codes

Question

Die Verbesserung der Verwendung von Rollen (Moo :: Rolle oder Rollen :: Tiny oder was auch immer)

with qw(
    Some::Role 
    Some::Other::Role 
); 
... 
some_roles_method(); 

über nur die Funktion aus der mixin Klasse explizit importieren

use Some::Role qw/some_roles_method/; 
... 
some_roles_method(); 

sind zahlreiche, und fügen hinzu, Flexibilität, weniger Buchhaltung (vor allem, wenn viele Methoden importiert werden), und nicht bestehende Methoden zu überschreiben.

Aber ein großer Nachteil ist, wenn Sie den Code lesen und Erwähnungen von some_roles_method() kommen und Sie die Funktion lesen möchten, ist es nicht sofort ersichtlich, wohin zu gehen. Alles, was Sie sagen können, ist, dass es nicht in dieser Datei definiert ist.

Gibt es irgendwelche guten Strategien, um das zu handhaben? Bin ich der Einzige, der stört?

Answer 1

Das einzige, was mir einfällt und das ich hin und wieder mache, ist, alles gründlich mit POD zu dokumentieren. Aber natürlich erfordert das viel der Disziplin.

use Moo; 
with 'Role::Reader', 'Role::Writer'; 

# ... 

=head1 METHODS 

=head2 frobnicate 

Frobnicates the foo. 

=cut 

sub frobnicate { ... } 

=head2 write_cheque 

This method is documented in L<Role::Writer>. 

=head2 write_autograph 

This method is documented in L<Role::Writer>. 

=head2 read_mind 

This method is documented in L<Role::Reader>. 

=head2 read_book 

This method is documented in L<Role::Reader>. 

=cut 

1;