(forgot to send this to the list... Sorry, Shlomi.)
On Thu, 20 Aug 2009 08:34 +0300, "Shlomi Fish" <shlo...@iglu.org.il>
wrote:
> Hi Curtis!
>
> On Thursday 20 August 2009 06:55:36 Curtis Jewell wrote:
> > I want to know what you guys think about the format of the module and
> > tests that Module::Starter::CSJEWELL creates. Good? Bad? Indifferent?
> > Would you recommend it? What do you think I need to improve?
> >
> > [I wrote this for myself, but I figured why not let other people
> > see/critique/use it?]
> >
>
> In http://search.cpan.org/perldoc?Module::Starter::CSJEWELL it would be
> useful
> if you mentioned how your module improves on (or at least deviates from
> ;-)
> Module-Starter. A bulleted list or a section would be ideal.
>
> I haven't looked more closely yet, but may at a point. But I think giving
> the
> "secret sauce" of M-S-CSJEWELL, and what makes it unique is essential in
> the
> documentation.
OK. It'll go in the next version. Anything that I've missed, tell me.
The idea is to document how I like to write modules, and to document
current best practices, and to create a starting framework that works
with those. In that regard, it builds on Module::Starter using its
plugin methodology.
Specifically, the ways it's different from Module::Starter::PBP:
1) $VERSION assignments along the lines of dagolden's recent blog post,
only changing the string eval to a block eval.
2) Author tests only running when $ENV{AUTOMATED_TESTING} or
$ENV{RELEASE_TESTING} are true.
3) Provides a sanely configured set of author tests, and more of them.
4) Suggestion to "use parent" rather than "use base", and to possibly
use Moose and Exception::Class.
5) Uses license boilerplate that I remember reading about recently from
TPF, if I recall correctly.
6) Suggests use of Pod::Readme to generate a sane readme file, and
Software::License to generate a LICENSE file.
'passthrough' Makefile.PL's may be deprecated soon
(https://rt.cpan.org/Public/Bug/Display.html?id=48884 ) now that
configure_requires is available, so I may take the use of that out for
next version.
Those should be the major points, I'll have to think of the minor
points.
--Curtis
--
Curtis Jewell
swords...@csjewell.fastmail.us
%DCL-E-MEM-BAD, bad memory
-VMS-F-PDGERS, pudding between the ears
[I use PC-Alpine, which deliberately does not display colors and
pictures in HTML mail]
