I am in inner turmoil about my placement of use statements in modules, and I wonder if some kind monks have any opinions to share. The goal is some kind of conceptual purity, and I've tried a variety of approaches but I'm never happy with one for longer than a module or two. Should the statements come before or after the package statement? Organized alphabetically, or by importance, or by type (pragma, module, base module)?
Stuff I've tried:
- package statement, then alphabetical listing like:
package Foobar;
use constant STR => 'quack';
use Data::Dumper;
use Quux;
use strict;
use warnings;
- package statement, pragmas, modules, base modules:
package Foobar;
use constant STR => 'quack';
use strict;
use warnings;
use Data::Dumper;
use base 'Quux';
- "importance":
package Foobar;
use base 'Quux';
use constant STR => 'quack';
use strict;
use warnings;
use Data::Dumper;
- (My current thoughts) Order by non-package-specific pragmas/modules, package statement, package-specific pragmas/modules.
use strict;
use warnings;
use Blarney;
package Foobar;
use constant STR => 'quack';
use Data::Dumper;
use base 'Quux';
The last one I think is the most precise, with a distinction between stuff that needs to be imported into the package Foobar vs. stuff that can exist happily in package main. But it may also be more confusing to someone just looking at the code. {sigh} Thoughts?
TIA, djantzen
"The dead do not recognize context" -- Kai, Lexx
-
Are you posting in the right place? Check out Where do I post X? to know for sure.
-
Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
<code> <a> <b> <big>
<blockquote> <br /> <dd>
<dl> <dt> <em> <font>
<h1> <h2> <h3> <h4>
<h5> <h6> <hr /> <i>
<li> <nbsp> <ol> <p>
<small> <strike> <strong>
<sub> <sup> <table>
<td> <th> <tr> <tt>
<u> <ul>
-
Snippets of code should be wrapped in
<code> tags not
<pre> tags. In fact, <pre>
tags should generally be avoided. If they must
be used, extreme care should be
taken to ensure that their contents do not
have long lines (<70 chars), in order to prevent
horizontal scrolling (and possible janitor
intervention).
-
Want more info? How to link
or How to display code and escape characters
are good places to start.
|