Re: Python OO v Moose

[choroba]

There should be some =pod in the Perl code to pair with the docstrings. Also, use ASCII single quotes ' (or nothing before the fat comma):

package OurClass;

=pod

=cut

use Moose;
has arg1 => (is => 'rw');
has arg2 => (is => 'rw');
sub printargs {
    my $self = shift;
    say $self->$_ for qw/arg1 arg2/;
}
no Moose;

[Ea]

The single quote strangeness was due to a copy/paste from GoogleDocs. I'll have to keep that in mind when using that to share code. The """ is starting to make more sense now. I'm not sure if I have any preferences for documentation style yet. I like POD for the space it gives the text, except when I don't want to look at it, especially since I tend to prefer keeping the documentation near the methods. Javadoc is easily hidden in Eclipse, but I'm a little put off by its differentness. I haven't seen a style that really grabs me so far.

I was in two minds in the printargs method. It looks better the way you've written it. I was trying to keep it simple so that people with no knowledge of Perl could see how it works, but I do like the for line. Likewise, I'd used lots of whitespace in the attribute distributions to make it 'friendlier'.

[tobyink]

I used to intersperse my pod and code, but eventually grew to dislike that, so now place all my pod at the end of the file.

Yes, there's something to be said for keeping documentation and code close together, but having them in the same file is close enough for me. Putting all the pod at the end I think encourages me to write documentation that flows better as a document - making the pod less a list of methods, and more a how-to.