NAME

LEOCHARRE::Dev - tools to help manage distro development and maintenance

DESCRIPTION

This package is a collection of modules and scripts to aid in development. Most of the functionality is in the set of cli scripts provided in distro, these reside under bin/

This distro is a set of tools to help me manage a distro- and development. It is in my namespace because a lot of the scripts and methods here are already available in other packages.

I find these set of tools very valuable.

For example,

- automatically generate pod from source
- analize your distro and tell what modules are deps and what versions are currently installed
- auto Makefile.PL and MANIFEST generation
- check out what version of a module is installed and if it's the most current on cpan
- etc

SUBS

These subs are contained in the main module. None are exported by default.

is_pmdist()

Argument is abs path to dist directory. If no argument provided, uses Cwd. Returns abs path resolved by Cww::abs_path

my $abs_dist = is_pmdist();
my $abs_dist = is_pmdist('./dev/My-Module');

We deem a directory to be a distro if a Makefile.PL file is present therein.

ls_pmdist()

Argument is path to distro dir. If left out, tries to use is_pmdist(). Returns list of files relative to dist dir, with no leading slash. (not array ref).

Leaves out CVS entries.

Executables

A number of useful perl module tools are present to aid in development.

AUTHOR

Leo Charre leocharre at cpan dot org

COPYRIGHT

Copyright (c) 2009 Leo Charre. All rights reserved.

LICENSE

This package is free software; you can redistribute it and/or modify it under the same terms as Perl itself, i.e., under the terms of the "Artistic License" or the "GNU General Public License".

DISCLAIMER

This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

See the "GNU General Public License" for more details.