There is an ongoing outage on the primary CPAN mirror. It is possible to work around the issue by using MetaCPAN as a mirror.

NAME

My::Module::Meta - Information needed to build Astro::UTDF

SYNOPSIS

use lib qw{ inc };
use My::Module::Meta;
my $meta = My::Module::Meta->new();
use YAML;
print "Required modules:\n", Dump(
    $meta->requires() );

DETAILS

This module centralizes information needed to build Astro::UTDF. It is private to the Astro::UTDF package, and may be changed or retracted without notice.

METHODS

This class supports the following public methods:

new

my $meta = My::Module::Meta->new();

This method instantiates the class.

abstract

This method returns the distribution's abstract.

add_to_cleanup

This method returns a reference to an array of files to be added to the cleanup.

author

This method returns the name of the distribution author

build_requires

use YAML;
print Dump( $meta->build_requires() );

This method computes and returns a reference to a hash describing the modules required to build the Astro::UTDF package, suitable for use in a Build.PL build_requires key, or a Makefile.PL {META_MERGE}->{build_requires} or BUILD_REQUIRES key.

configure_requires

use YAML;
print Dump( $meta->configure_requires() );

This method returns a reference to a hash describing the modules required to configure the package, suitable for use in a Build.PL configure_requires key, or a Makefile.PL {META_MERGE}->{configure_requires} or CONFIGURE_REQUIRES key.

dist_name

This method returns the distribution name.

distribution

if ( $meta->distribution() ) {
    print "Making distribution\n";
} else {
    print "Not making distribution\n";
}

This method returns the value of the environment variable MAKING_MODULE_DISTRIBUTION at the time the object was instantiated.

license

This method returns the distribution's license.

meta_merge

use YAML;
print Dump( $meta->meta_merge() );

This method returns a reference to a hash describing the meta-data which has to be provided by making use of the builder's meta_merge functionality. This includes the dynamic_config and resources data.

Any arguments will be appended to the generated array.

module_name

This method returns the name of the module the distribution is based on.

no_index

This method returns the names of things which are not to be indexed by CPAN.

provides

use YAML;
print Dump( [ $meta->provides() ] );

This method attempts to load Module::Metadata. If this succeeds, it returns a provides entry suitable for inclusion in meta_merge() data (i.e. 'provides' followed by a hash reference). If it can not load the required module, it returns nothing.

requires

use YAML;
print Dump( $meta->requires() );

This method computes and returns a reference to a hash describing the modules required to run the Astro::UTDF package, suitable for use in a Build.PL requires key, or a Makefile.PL PREREQ_PM key. Any additional arguments will be appended to the generated hash. In addition, unless distribution() is true, configuration-specific modules may be added.

requires_perl

print 'This package requires Perl ', $meta->requires_perl(), "\n";

This method returns the version of Perl required by the package.

script_files

This method returns a reference to an array containing the names of script files provided by this distribution. This array may be empty.

version_from

This method returns the name of the distribution file from which the distribution's version is to be derived.

ATTRIBUTES

This class has no public attributes.

ENVIRONMENT

MAKING_MODULE_DISTRIBUTION

This environment variable should be set to a true value if you are making a distribution. This ensures that no configuration-specific information makes it into META.yml.

SUPPORT

Support is by the author. Please file bug reports at https://rt.cpan.org/Public/Dist/Display.html?Name=Astro-UTDF, https://github.com/trwyant/perl-Astro-UTDF/issues, or in electronic mail to the author.

AUTHOR

Thomas R. Wyant, III wyant at cpan dot org

COPYRIGHT AND LICENSE

Copyright (C) 2010-2021 by Thomas R. Wyant, III

This program is free software; you can redistribute it and/or modify it under the same terms as Perl 5.10.0. For more details, see the full text of the licenses in the directory LICENSES.

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.