NAME
   Module::Install::AggressiveInclude - A more aggressive include

VERSION
   Version 0.01

SYNOPSIS
   At times Module::Install's include() function may not be enough for you.
   In that case Module::Install::AggressiveInclude may be what you need.

   Often for local development I tend to shy away from installing packages
   I may be working on so when working with packages that have multiple
   local dependencies I find my self writing this Makefile.PL code a lot:

       # use lib for my local libraries somewhere around here
       # ...

       build_requires 'Module::Find';
       require Module::Find;

       include 'FooPackage';
       include $_ foreach Module::Find::findallmod 'FooPackage::*';

       # so on and so forth

   Why? You may ask when Module::Install has a support for glob matching of
   packages. Well, because for my (and maybe yours) it is not powerful
   enough when it comes to deep includes.

   For example say we have a lot of modules we want to include from the
   same namespace:

       FooPackage
       FooPackage::Alpha
       FooPackage::Alpha::I
       FooPackage::Alpha::II
       FooPackage::Beta
       FooPackage::Beta::I
       FooPackage::Beta::II
       FooPackage::Gamma
       FooPackage::Gamma::I
       FooPackage::Gamma::II

   If we use Module::Install's include function like this:

       include 'FooPackage::*';

   Only these packages will get included:

       FooPackage::Alpha
       FooPackage::Beta
       FooPackage::Gamma
       # Not even plain ol' FooPackage is included

   In my opinion this lacks some DWIM functionality. So instead we do:

       include_aggressive 'FooPackage';

   And we will get the base package as well as every class under it's
   namespace.

METHODS
 include_aggressive PACKAGE
   Aggressively include PACKAGE and all the modules/packages that fall
   under it

 include_findallmod
   Ties Module::Find::findallmod to Module::Install::include.

 include_findsubmod
   Ties Module::Find::findsubmod to Module::Install::include.

 include_followsymlinks
   Interface with Module::Find::followsymlinks.

 include_ignoresymlinks
   Interface with Module::Find::ignoresymlinks.

AUTHOR
   Jason M Mills, "<jmmills at cpan.org>"

BUGS
   Please report any bugs or feature requests to
   "bug-module-install-aggressiveinclude at rt.cpan.org", or through the
   web interface at
   <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Module-Install-Aggressiv
   eInclude>. I will be notified, and then you'll automatically be notified
   of progress on your bug as I make changes.

SUPPORT
   You can find documentation for this module with the perldoc command.

       perldoc Module::Install::AggressiveInclude

   You can also look for information at:

   *   RT: CPAN's request tracker

       <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Module-Install-AggressiveI
       nclude>

   *   AnnoCPAN: Annotated CPAN documentation

       <http://annocpan.org/dist/Module-Install-AggressiveInclude>

   *   CPAN Ratings

       <http://cpanratings.perl.org/d/Module-Install-AggressiveInclude>

   *   Search CPAN

       <http://search.cpan.org/dist/Module-Install-AggressiveInclude/>

ACKNOWLEDGEMENTS
LICENSE AND COPYRIGHT
   Copyright 2010 Jason M Mills.

   This program is free software; you can redistribute it and/or modify it
   under the terms of either: the GNU General Public License as published
   by the Free Software Foundation; or the Artistic License.

   See http://dev.perl.org/licenses/ for more information.

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.