/ 
App-Midgen-0.12
River stage zero No dependents
/ App::Midgen

NAME

App::Midgen - Check requires & test_rerquires of your Package for CPAN inclusion.

VERSION

This document describes App::Midgen version: 0.12

SYNOPSIS

Change to the root of your package and run

midgen

Now with a Getopt --help or -?

midgen -?

See midgen for cmd line option info.

DESCRIPTION

This is an aid to present a packages module requirements by scanning the package, then displaying in a familiar format with the current version number from CPAN.

This started out as a way of generating the core for a Module::Install::DSL Makefile.PL, why DSL because it's nice and clean, so now you can generate the contents and check when you want, yes it's another PPI powered app.

All output goes to STDOUT, so you can use it as you see fit.

CPAN Version Number Displayed

  • NN.nnnnnn we got the current version number from CPAN (numify)

  • 'undef' no version number returned by CPAN

  • 'core' indicates the module is a perl core module

  • '!cpan' must be local, one of yours. Not in CPAN, Not in core.

Food for thought, if we update our Modules, don't we want our users to use the current version, so should we not by default do the same with others Modules. Thus we always show the current version number, regardless.

We also display some other info to complement the modules we have found.

For more info and sample output see wiki

METHODS

  • base_parent

    Check inside base/parent pragmas for modules to include

  • find_required_modules

    Search for Includes use and require in package modules

  • find_required_test_modules

    Search for Includes use and require in test scripts, also use_ok, plus some other patterns along the way.

  • first_package_name

    Assume first package found is your packages name

  • min_version

    Uses Perl::MinimumVersion to find the minimum version of your package by taking a quick look, note this is not a full scan see perlver for a full scan.

  • remove_noisy_children

    Parent A::B has noisy Children A::B::C and A::B::D all with same version number.

  • remove_twins

    Twins E::F::G and E::F::H have a parent E::F with same version number, so we add a parent E::F and re-test for noisy children, catching triplets along the way.

  • run

CONFIGURATION AND ENVIRONMENT

App::Midgen requires no configuration files or environment variables.

DEPENDENCIES

App::Midgen::Roles, App::Midgen::Output,

INCOMPATIBILITIES

After some reflection, we do not scan xt/... as the methods by which the modules Included are varied, this is best left to the module Author.

WARNINGS

You should have access to http://www.cpan.org/, or one of it's mirrors.

Start-up may be slow, especially if it we need to do the equivalent of, CPAN reload index.

BUGS AND LIMITATIONS

Please report any bugs or feature requests to through the web interface at https://github.com/kevindawson/App-Midgen/issues. If reporting a Bug, also supply the Module info, midgen failed against.

AUTHOR

Kevin Dawson <bowtie@cpan.org>

CONTRIBUTORS

Ahmad M. Zawawi <ahmad.zawawi@gmail.com>

Matt S. Trout <mst@shadowcat.co.uk>

Tommy Butler <ace@tommybutler.me>

COPYRIGHT

Copyright © 2013 the App:Midgen "AUTHOR" and "CONTRIBUTORS" as listed above.

LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl 5 itself.

SEE ALSO

Perl::PrereqScanner, Module::Install::DSL,

DISCLAIMER OF WARRANTY

BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.