module::install::authorrequires(3pm) [debian man page]

Module::Install::AuthorRequires(3pm)			User Contributed Perl Documentation		      Module::Install::AuthorRequires(3pm)

NAME

       Module::Install::AuthorRequires - declare author-only dependencies

SYNOPSIS

	   author_requires 'Some::Module';
	   author_requires 'Another::Module' => '0.42';

DESCRIPTION

       Modules often have optional requirements, for example dependencies that are useful for (optional) tests, but not required for the module to
       work properly.

       Usually you want all developers of a project to have these optional modules installed. However, simply telling everyone or printing
       diagnostic messages if optional dependencies are missing often isn't enough to make sure all authors have all optional modules installed.

       "Module::Install" already has a way of detecting an author environment, so an easy way to achieve the above would be something like:

	   if ($Module::Install::AUTHOR) {
	       requires 'Some::Module';
	       requires 'Another::Module' => '0.42';
	   }

       Unfortunately, that'll also make the optional dependencies show up in the distributions "META.yml" file, which is obviously wrong, as they
       aren't actually hard requirements.

       Working that around requires a considerable amount of non-trivial Makefile.PL hackery, or simply using this module's "author_requires"
       command.

COMMANDS

   author_requires
	   author_requires $module;
	   author_requires $module => $version;

       This declares a hard dependency, that's only enforced in author environments and is not put in the generate "META.yml" file of the
       distribution.

AUTHOR

       Florian Ragwitz <rafl@debian.org>

COPYRIGHT AND LICENSE

       Copyright (c) 2009  Florian Ragwitz

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

perl v5.14.2							    2009-07-14				      Module::Install::AuthorRequires(3pm)

Check Out this Related Man Page

Module::Depends(3pm)					User Contributed Perl Documentation				      Module::Depends(3pm)

NAME

       Module::Depends - identify the dependencies of a distribution

SYNOPSIS

	use Module::Depends;
	my $deps = Module::Depends->new->dist_dir( '.' )->find_modules;
	print "Our dependencies:
", Dump $deps->requires;

DESCRIPTION

       Module::Depends extracts module dependencies from an unpacked distribution tree.

       Module::Depends only evaluates the META.yml shipped with a distribution.  This won't be effective until all distributions ship META.yml
       files, so we suggest you take your life in your hands and look at Module::Depends::Intrusive.

METHODS

   new
       simple constructor

   dist_dir
       Path where the distribution has been extracted to.

   find_modules
       scan the "dist_dir" to populate "libs", "requires", "configure_requires", "test_requires", and "build_requires"

   libs
       an array reference of lib lines

   requires
       A reference to a hash enumerating the prerequisite modules for this distribution.

   configure_requires
       A reference to a hash enumerating the prerequisite modules to configure this distribution.

   build_requires
       A reference to a hash enumerating the modules needed to build the distribution.

   error
       A reason, if any, for failing to get dependencies.

AUTHOR

       Richard Clamp, based on code extracted from the Fotango build system originally by James Duncan and Arthur Bergman.

COPYRIGHT

       Copyright 2010, Richard Clamp.  Copyright 2004-2008, Fotango.

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

SEE ALSO

       Module::Depends::Intrusive

perl v5.14.2							    2012-06-10						      Module::Depends(3pm)

Linux and UNIX Man Pages

module::install::authorrequires(3pm) [debian man page]

Check Out this Related Man Page