Beefy Boxes and Bandwidth Generously Provided by pair Networks
The stupid question is the question not asked
 
PerlMonks  

Re^2: how do you build and test your modules locally before publishing

by gideondsouza (Pilgrim)
on Dec 31, 2012 at 03:57 UTC ( #1010986=note: print w/ replies, xml ) Need Help??


in reply to Re: how do you build and test your modules locally before publishing
in thread how do you build and test your modules locally before publishing

Thanks very much for your reply davido. Exactly what I was looking for

One more little query, the perldoc command doesn't seem to have a -I switch. How should I test if the POD I've written looks ok? How is it usually done?


Comment on Re^2: how do you build and test your modules locally before publishing
Download Code
Re^3: how do you build and test your modules locally before publishing
by davido (Archbishop) on Dec 31, 2012 at 04:01 UTC

    Test::Pod, and Test::Pod::Coverage, if memory serves. Also, Perl::Critic: One of the elevated levels of whining will grouse at you if your POD is missing sections common to modules. I think Test::Kwalitee does some POD diving too, but half the time I can't even get it to install all of its deps. Test::Kwalitee and Test::PerlCritic should always be "author-only" tests, by the way.


    Dave

Re^3: how do you build and test your modules locally before publishing
by tobyink (Abbot) on Dec 31, 2012 at 11:35 UTC

    perldoc allows you to provide a file path rather than a module name...

    perldoc File::Spec perldoc lib/Foo/Bar.pm

    I tend to view my pod in an 80x24 terminal to check there's no ugly line wrapping issues at that size.

    I also check with Test::Pod and Test::Pod::Coverage.

    perl -E'sub Monkey::do{say$_,for@_,do{($monkey=[caller(0)]->[3])=~s{::}{ }and$monkey}}"Monkey say"->Monkey::do'

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://1010986]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others meditating upon the Monastery: (5)
As of 2014-12-27 13:19 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    Is guessing a good strategy for surviving in the IT business?





    Results (177 votes), past polls