cpan::meta::check(3) [osx man page]

CPAN::Meta::Check(3)					User Contributed Perl Documentation				      CPAN::Meta::Check(3)

NAME

       CPAN::Meta::Check - Verify requirements in a CPAN::Meta object

VERSION

       version 0.004

SYNOPSIS

	warn "$_
" for verify_requirements($meta, [qw/runtime build test/], 'requires');

DESCRIPTION

       This module verifies if requirements described in a CPAN::Meta object are present.

FUNCTIONS

   check_requirements($reqs, $type)
       This function checks if all dependencies in $reqs (a CPAN::Meta::Requirements object) are met, taking into account that 'conflicts'
       dependencies have to be checked in reverse. It returns a hash with the modules as values and any problems as keys, the value for a
       succesfully found module will be undef.

   verify_dependencies($meta, $phases, $types, $incdirs)
       Check all requirements in $meta for phases $phases and types $types. Modules are searched for in @$incdirs, defaulting to @INC.

   requirements_for($meta, $phases, $types, incdirs)
       This function returns a unified CPAN::Meta::Requirements object for all $type requirements for $phases. $phases may be either one (scalar)
       value or an arrayref of valid values as defined by the CPAN::Meta spec. $type must be a a relationship as defined by the same spec. Modules
       are searched for in @$incdirs, defaulting to @INC.

SEE ALSO

       o   Test::CheckDeps

       o   CPAN::Meta

AUTHOR

       Leon Timmermans <leont@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 by Leon Timmermans.

       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.16.2							    2012-05-24						      CPAN::Meta::Check(3)

CPAN::Meta::Prereqs(3)					User Contributed Perl Documentation				    CPAN::Meta::Prereqs(3)

NAME

       CPAN::Meta::Prereqs - a set of distribution prerequisites by phase and type

VERSION

       version 2.133380

DESCRIPTION

       A CPAN::Meta::Prereqs object represents the prerequisites for a CPAN distribution or one of its optional features.  Each set of prereqs is
       organized by phase and type, as described in CPAN::Meta::Prereqs.

METHODS

   new
	 my $prereq = CPAN::Meta::Prereqs->new( \%prereq_spec );

       This method returns a new set of Prereqs.  The input should look like the contents of the "prereqs" field described in CPAN::Meta::Spec,
       meaning something more or less like this:

	 my $prereq = CPAN::Meta::Prereqs->new({
	   runtime => {
	     requires => {
	       'Some::Module' => '1.234',
	       ...,
	     },
	     ...,
	   },
	   ...,
	 });

       You can also construct an empty set of prereqs with:

	 my $prereqs = CPAN::Meta::Prereqs->new;

       This empty set of prereqs is useful for accumulating new prereqs before finally dumping the whole set into a structure or string.

   requirements_for
	 my $requirements = $prereqs->requirements_for( $phase, $type );

       This method returns a CPAN::Meta::Requirements object for the given phase/type combination.  If no prerequisites are registered for that
       combination, a new CPAN::Meta::Requirements object will be returned, and it may be added to as needed.

       If $phase or $type are undefined or otherwise invalid, an exception will be raised.

   with_merged_prereqs
	 my $new_prereqs = $prereqs->with_merged_prereqs( $other_prereqs );

	 my $new_prereqs = $prereqs->with_merged_prereqs( @other_prereqs );

       This method returns a new CPAN::Meta::Prereqs objects in which all the other prerequisites given are merged into the current set.  This is
       primarily provided for combining a distribution's core prereqs with the prereqs of one of its optional features.

       The new prereqs object has no ties to the originals, and altering it further will not alter them.

   merged_requirements
	   my $new_reqs = $prereqs->merged_requirements( @phases, @types );
	   my $new_reqs = $prereqs->merged_requirements( @phases );
	   my $new_reqs = $preerqs->merged_requirements();

       This method joins together all requirements across a number of phases and types into a new CPAN::Meta::Requirements object.  If arguments
       are omitted, it defaults to "runtime", "build" and "test" for phases and "requires" and "recommends" for types.

   as_string_hash
       This method returns a hashref containing structures suitable for dumping into a distmeta data structure.  It is made up of hashes and
       strings, only; there will be no Prereqs, CPAN::Meta::Requirements, or "version" objects inside it.

   is_finalized
       This method returns true if the set of prereqs has been marked "finalized," and cannot be altered.

   finalize
       Calling "finalize" on a Prereqs object will close it for further modification.  Attempting to make any changes that would actually alter
       the prereqs will result in an exception being thrown.

   clone
	 my $cloned_prereqs = $prereqs->clone;

       This method returns a Prereqs object that is identical to the original object, but can be altered without affecting the original object.
       Finalization does not survive cloning, meaning that you may clone a finalized set of prereqs and then modify the clone.

BUGS

       Please report any bugs or feature using the CPAN Request Tracker.  Bugs can be submitted through the web interface at
       <http://rt.cpan.org/Dist/Display.html?Queue=CPAN-Meta>

       When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired
       feature.

AUTHORS

       o   David Golden <dagolden@cpan.org>

       o   Ricardo Signes <rjbs@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2010 by David Golden and Ricardo Signes.

       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.18.2							    2013-12-03						    CPAN::Meta::Prereqs(3)