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

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

NAME

       Module::Install::TrustMetaYml - trusts META.yml list of dependencies

SYNOPSIS

       In Makefile.PL:

	       trust_meta_yml;

DESCRIPTION

       CPAN doesn't trust "META.yml"'s list of dependencies for a module. Instead it expects "Makefile.PL" run on the computer the package is
       being installed upon to generate its own list of dependencies (called "MYMETA.yml" or "MYMETA.json").

       This module is a Module::Install plugin that generates "MYMETA.yml" by simply passing through the dependencies from "META.yml".

       It does nothing when run from the module author's development copy.

       The module defines two functions which are aliases for each other:

       "trust_meta_yml"
       "trust_meta_yaml"

BUGS

       Please report any bugs to http://rt.cpan.org/Dist/Display.html?Queue=Module-Install-TrustMetaYml
       <http://rt.cpan.org/Dist/Display.html?Queue=Module-Install-TrustMetaYml>.

SEE ALSO

       Module::Install, Module::Package::RDF.

AUTHOR

       Toby Inkster <tobyink@cpan.org>.

CREDITS

       Thanks to Chris Williams (BINGOS), Ingy dA~Xt Net (INGY) and Florian Ragwitz (FLORA) for explaining the role of "MYMETA.json", and helping
       me figure out why mine weren't working.

COPYRIGHT AND LICENCE

       This software is copyright (c) 2011 by Toby Inkster.

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

DISCLAIMER OF WARRANTIES

       THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
       MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

perl v5.14.2							    2011-10-05					Module::Install::TrustMetaYml(3pm)

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)