Your IP : 216.73.216.86
history/META-spec-1_0.html 0000644 00000013306 15170246504 0011175 0 ustar 00 <html>
<head>
<title>Specification for META.yml</title>
</head>
<body>
<h2 align=center>Specification for the META.yml file</h2>
<p>This document describes version 1.0 of the META.yml specification.</p>
<p>
The META.yml file describes important properties of contributed Perl
distributions such as the ones found on <a
href="http://www.cpan.org">CPAN</a>. It is typically created by tools
like <a
href="http://search.cpan.org/author/KWILLIAMS/Module-Build/">Module::Build</a>
and <a
href="http://search.cpan.org/author/MSCHWERN/ExtUtils-MakeMaker/">ExtUtils::MakeMaker</a>.
</p>
<p>
The fields in the META.yml file are meant to be helpful to people
maintaining module collections (like CPAN), for people writing
installation tools (like <a
href="http://search.cpan.org/author/ANDK/CPAN/">CPAN.pm</a> or <a
href="http://search.cpan.org/author/KANE/CPANPLUS/">CPANPLUS</a>), or
just people who want to know some stuff about a distribution before
downloading it and starting to install it.
</p>
<h3>Format</h3>
<p>
META.yml files are written in the <a
href="http://www.yaml.org/">YAML</a> format. The reasons we chose
YAML instead of, say, XML or Data::Dumper are discussed in <a
href="http://archive.develooper.com/makemaker@perl.org/msg00405.html">this
thread</a> on the MakeMaker mailing list.
</p>
<p>
The first line of a META.yml file should be a valid <a
href="http://www.yaml.org/spec/#.Document">YAML document header</a>
like <nobr><tt>"--- #YAML:1.0"</tt></nobr>.
</p>
<h3>Fields</h3>
<p>
The rest of the META.yml file is one big YAML <a
href="http://www.yaml.org/spec/#.-syntax-mapping-Mapping-">mapping</a>,
whose keys are described here.
</p>
<ul>
<li><b>name</b><br>
Example: <b>Module-Build</b>
<p>
The name of the distribution. Often created by taking the "main
module" in the distribution and changing "::" to "-". Sometimes it's
completely different, however, as in the case of the <a
href="http://search.cpan.org/author/GAAS/libwww-perl/">libwww-perl</a>
distribution.
</p>
<li><b>version</b><br>
Example: <b>0.16</b>
<p>
The version of the distribution to which the META.yml file refers.
</p>
<li><b>license</b><br>
Example: <b>perl</b>
<p>
The license under which this distribution may be used and
redistributed. See <a
href="http://search.cpan.org/author/KWILLIAMS/Module-Build/">Module::Build</a>
for the list of valid options.
</p>
<li><b>distribution_type</b><br>
Example: <b>module</b>
<p>
What kind of stuff is contained in this distribution. Most things on
CPAN are <code>module</code>s (which can also mean a collection of
modules), but some things are <code>script</code>s.
</p>
<li><b>requires</b><br>
Example:<br>
<b>
Data::Dumper: 0<br>
File::Find: 1.03<br>
</b>
<p>
A YAML <a
href="http://www.yaml.org/spec/#.-syntax-mapping-Mapping-">mapping</a>
indicating the Perl modules this distribution requires for proper
operation. The keys are the module names, and the values are version
specifications as described in the <a
href="http://search.cpan.org/author/KWILLIAMS/Module-Build/lib/Module/Build.pm">
documentation for Module::Build's "requires" parameter</a>.
</p>
<p><i>Note: the exact nature of the fancy specifications like
<nobr><tt>">= 1.2, != 1.5, < 2.0"</tt></nobr> is subject to
change. Advance notice will be given here. The simple specifications
like <tt>"1.2"</tt> will not change in format.</i>
</p>
<li><b>recommends</b><br>
Example:<br>
<b>
Data::Dumper: 0<br>
File::Find: 1.03<br>
</b>
<p>
A YAML <a
href="http://www.yaml.org/spec/#.-syntax-mapping-Mapping-">mapping</a>
indicating the Perl modules this distribution recommends for enhanced
operation.
</p>
<li><b>build_requires</b><br>
Example:<br>
<b>
Data::Dumper: 0<br>
File::Find: 1.03<br>
</b>
<p>
A YAML <a
href="http://www.yaml.org/spec/#.-syntax-mapping-Mapping-">mapping</a>
indicating the Perl modules required for building and/or testing of
this distribution. These dependencies are not required after the
module is installed.
</p>
<li><b>conflicts</b><br>
Example:<br>
<b>
Data::Dumper: 0<br>
File::Find: 1.03<br>
</b>
<p>
A YAML <a
href="http://www.yaml.org/spec/#.-syntax-mapping-Mapping-">mapping</a>
indicating the Perl modules that cannot be installed while this
distribution is installed. This is a pretty uncommon situation.
</p>
<li><b>dynamic_config</b><br>
Example: <b>0</b>
<p>
A boolean flag indicating whether a <tt>Build.PL</tt> or
<tt>Makefile.PL</tt> (or similar) must be executed, or whether this
module can be built, tested and installed solely from consulting its
metadata file. The main reason to set this to a true value if that
your module performs some dynamic configuration (asking questions,
sensing the environment, etc.) as part of its build/install process.
</p>
<p>
Currently <tt>Module::Build</tt> doesn't actually do anything with
this flag - it's probably going to be up to higher-level tools like
<tt>CPAN.pm</tt> to do something useful with it. It can potentially
bring lots of security, packaging, and convenience improvements.
</p>
<li><b>generated_by</b><br>
Example: <b>Module::Build version 0.16</b>
<p>
Indicates the tool that was used to create this META.yml file. It's
good form to include both the name of the tool and its version, but
this field is essentially opaque, at least for the moment.
</p>
</ul>
<h3>Related Projects</h3>
<dl>
<dt>DOAP</dt>
<dd>An RDF vocabulary to describe software projects. <a
href="http://usefulinc.com/doap">http://usefulinc.com/doap</a>.</dd>
</dl>
<h3>History</h3>
<ul>
<li><b>March 14, 2003</b> (Pi day) - created version 1.0 of this document.</li>
<li><b>May 8, 2003</b> - added the "dynamic_config" field, which was
missing from the initial version.</li>
</ul>
</body>
</html>
history/META-spec-1_1.html 0000644 00000017247 15170246504 0011206 0 ustar 00 <html>
<head>
<title>Specification for META.yml</title>
</head>
<body>
<h2 align=center>Specification for the META.yml file</h2>
<p>This document describes version 1.0 of the META.yml specification.</p>
<p>
The META.yml file describes important properties of contributed Perl
distributions such as the ones found on <a
href="http://www.cpan.org">CPAN</a>. It is typically created by tools
like <a
href="http://search.cpan.org/author/KWILLIAMS/Module-Build/">Module::Build</a>
and <a
href="http://search.cpan.org/author/MSCHWERN/ExtUtils-MakeMaker/">ExtUtils::MakeMaker</a>.
</p>
<p>
The fields in the META.yml file are meant to be helpful to people
maintaining module collections (like CPAN), for people writing
installation tools (like <a
href="http://search.cpan.org/author/ANDK/CPAN/">CPAN.pm</a> or <a
href="http://search.cpan.org/author/KANE/CPANPLUS/">CPANPLUS</a>), or
just people who want to know some stuff about a distribution before
downloading it and starting to install it.
</p>
<h3>Format</h3>
<p>
META.yml files are written in the <a
href="http://www.yaml.org/">YAML</a> format. The reasons we chose
YAML instead of, say, XML or Data::Dumper are discussed in <a
href="http://archive.develooper.com/makemaker@perl.org/msg00405.html">this
thread</a> on the MakeMaker mailing list.
</p>
<p>
The first line of a META.yml file should be a valid <a
href="http://www.yaml.org/spec/#.Document">YAML document header</a>
like <nobr><tt>"--- #YAML:1.0"</tt></nobr>.
</p>
<h3>Fields</h3>
<p>
The rest of the META.yml file is one big YAML <a
href="http://www.yaml.org/spec/#.-syntax-mapping-Mapping-">mapping</a>,
whose keys are described here.
</p>
<ul>
<li><b>name</b><br>
Example: <b>Module-Build</b>
<p>
The name of the distribution. Often created by taking the "main
module" in the distribution and changing "::" to "-". Sometimes it's
completely different, however, as in the case of the <a
href="http://search.cpan.org/author/GAAS/libwww-perl/">libwww-perl</a>
distribution.
</p>
<li><b>version</b><br>
Example: <b>0.16</b>
<p>
The version of the distribution to which the META.yml file refers.
This is a mandatory field.
</p>
<p>
The version is essentially an arbitrary string, but <i>must</i> be
only ASCII characters, and <i>strongly should</i> be of the format
integer-dot-digit-digit, i.e. <tt>25.57</tt>, optionally followed by
underscore-digit-digit, i.e. <tt>25.57_04</tt>.
</p>
<p>
The standard tools that deal with module distribution (PAUSE, CPAN,
etc.) form an identifier for each distribution by joining the 'name'
and 'version' attributes with a dash (<tt>-</tt>) character. Tools
who are prepared to deal with distributions that have no version
numbers generally omit the dash as well.
</p>
<li><b>license</b><br>
Example: <b>perl</b>
<p>
a descriptive term for the licenses ... not authoritative, but must
be consistent with licensure statements in the READMEs, documentation, etc.
</p>
<p>
The license under which this distribution may be used and
redistributed. See <a
href="http://search.cpan.org/author/KWILLIAMS/Module-Build/">Module::Build</a>
for the list of valid options.
</p>
<li><b>license_uri</b><br>
<p>
This should contain a URI where the exact terms of the license may be found.
</p>
(change "unrestricted" to "redistributable"?)
<li><b>distribution_type</b><br>
Example: <b>module</b>
<p>
What kind of stuff is contained in this distribution. Most things on
CPAN are <code>module</code>s (which can also mean a collection of
modules), but some things are <code>script</code>s.
</p>
This field is basically meaningless, and tools (like Module::Build or
MakeMaker) will likely stop generating it in the future.
<li><b>private</b><br>
WTF is going on here?
index_ignore: any application that indexes the contents of
distributions (PAUSE, search.cpan.org) ought to ignore the items
(packages, files, directories, namespace hierarchies).
<li><b>requires</b><br>
Example:<br>
<b>
Data::Dumper: 0<br>
File::Find: 1.03<br>
</b>
<p>
A YAML <a
href="http://www.yaml.org/spec/#.-syntax-mapping-Mapping-">mapping</a>
indicating the Perl modules this distribution requires for proper
operation. The keys are the module names, and the values are version
specifications as described in the <a
href="http://search.cpan.org/author/KWILLIAMS/Module-Build/lib/Module/Build.pm">
documentation for Module::Build's "requires" parameter</a>.
</p>
<p><i>Note: the exact nature of the fancy specifications like
<nobr><tt>">= 1.2, != 1.5, < 2.0"</tt></nobr> is subject to
change. Advance notice will be given here. The simple specifications
like <tt>"1.2"</tt> will not change in format.</i>
</p>
<li><b>recommends</b><br>
Example:<br>
<b>
Data::Dumper: 0<br>
File::Find: 1.03<br>
</b>
<p>
A YAML <a
href="http://www.yaml.org/spec/#.-syntax-mapping-Mapping-">mapping</a>
indicating the Perl modules this distribution recommends for enhanced
operation.
</p>
<li><b>build_requires</b><br>
Example:<br>
<b>
Data::Dumper: 0<br>
File::Find: 1.03<br>
</b>
<p>
A YAML <a
href="http://www.yaml.org/spec/#.-syntax-mapping-Mapping-">mapping</a>
indicating the Perl modules required for building and/or testing of
this distribution. These dependencies are not required after the
module is installed.
</p>
<li><b>conflicts</b><br>
Example:<br>
<b>
Data::Dumper: 0<br>
File::Find: 1.03<br>
</b>
<p>
A YAML <a
href="http://www.yaml.org/spec/#.-syntax-mapping-Mapping-">mapping</a>
indicating the Perl modules that cannot be installed while this
distribution is installed. This is a pretty uncommon situation.
</p>
- possibly separate out test-time prereqs, complications include: can
tests be meaningfully preserved for later running? are test-time
prereqs in addition to build-time, or exclusive?
- make official location for installed *distributions*, which can
contain tests, etc.
<li><b>dynamic_config</b><br>
Example: <b>0</b>
<p>
A boolean flag indicating whether a <tt>Build.PL</tt> or
<tt>Makefile.PL</tt> (or similar) must be executed, or whether this
module can be built, tested and installed solely from consulting its
metadata file. The main reason to set this to a true value if that
your module performs some dynamic configuration (asking questions,
sensing the environment, etc.) as part of its build/install process.
</p>
<p>
Currently <tt>Module::Build</tt> doesn't actually do anything with
this flag - it's probably going to be up to higher-level tools like
<tt>CPAN.pm</tt> to do something useful with it. It can potentially
bring lots of security, packaging, and convenience improvements.
</p>
<li><b>generated_by</b><br>
Example: <b>Module::Build version 0.16</b>
<p>
Indicates the tool that was used to create this META.yml file. It's
good form to include both the name of the tool and its version, but
this field is essentially opaque, at least for the moment.
</p>
* Ingy's suggestions
short_description: (add as field, containing abstract, maximum 80 characters, suggested minimum 40 characters)
description: (long version of abstract, should add?)
maturity: alpha, beta, gamma, mature, stable
author_id, owner_id:
categorization, keyword, chapter_id:
URL for further information: (could default to search.cpan.org on PAUSE)
namespaces: can be specified for single elements by prepending
dotted-form, i.e. "com.example.my_application.my_property". Default
namespace for META.yml is probably "org.cpan.meta_author" or
something. Precedent for this is Apple's Carbon namespaces, I think.
</ul>
<h3>History</h3>
<ul>
<li><b>March 14, 2003</b> (Pi day) - created version 1.0 of this document.</li>
<li><b>May 8, 2003</b> - added the "dynamic_config" field, which was
missing from the initial version.</li>
</ul>
</body>
</html>
history/META-spec-1_2.pod 0000644 00000035764 15170246504 0011031 0 ustar 00 =head1 NAME
META-spec - Specification for F<META.yml> documents
=head1 SYNOPSIS
--- #YAML:1.0
name: Module-Build
abstract: Build and install Perl modules
version: 0.20
author:
- Ken Williams <kwilliams@cpan.org>
license: perl
distribution_type: module
requires:
Config: 0
Cwd: 0
Data::Dumper: 0
ExtUtils::Install: 0
File::Basename: 0
File::Compare: 0
File::Copy: 0
File::Find: 0
File::Path: 0
File::Spec: 0
IO::File: 0
perl: 5.005_03
recommends:
Archive::Tar: 1.00
ExtUtils::Install: 0.3
ExtUtils::ParseXS: 2.02
Pod::Text: 0
YAML: 0.35
build_requires:
Test: 0
urls:
license: http://dev.perl.org/licenses/
meta-spec:
version: 1.2
url: http://module-build.sourceforge.net/META-spec-v1.2.html
generated_by: Module::Build version 0.20
=head1 DESCRIPTION
This document describes version 1.2 of the F<META.yml> specification.
The F<META.yml> file describes important properties of contributed
Perl distributions such as the ones found on CPAN. It is typically
created by tools like Module::Build, Module::Install, and
ExtUtils::MakeMaker.
The fields in the F<META.yml> file are meant to be helpful for people
maintaining module collections (like CPAN), for people writing
installation tools (like CPAN.pm or CPANPLUS), or just for people who
want to know some stuff about a distribution before downloading it and
starting to install it.
I<Note: The latest stable version of this specification can always be
found at L<http://module-build.sourceforge.net/META-spec-current.html>,
and the latest development version (which may include things that
won't make it into the stable version can always be found at
L<http://module-build.sourceforge.net/META-spec-blead.html>.>
=head1 FORMAT
F<META.yml> files are written in the YAML format (see
L<http://www.yaml.org/>).
See the following links to learn why we chose YAML instead of, say,
XML or Data::Dumper:
=over 4
=item *
Module::Build design plans
L<http://nntp.x.perl.org/group/perl.makemaker/406>
=item *
Not keen on YAML
L<http://nntp.x.perl.org/group/perl.module-authors/1353>
=item *
META Concerns
L<http://nntp.x.perl.org/group/perl.module-authors/1385>
=back
=head1 TERMINOLOGY
=over 4
=item distribution
This is the primary object described by the F<META.yml>
specification. In the context of this document it usually refers to a
collection of modules, scripts, and/or documents that are distributed
for other developers to use.
=item module
This refers to a reusable library of code typically contained in a
single file. Currently, we primarily talk of perl modules, but this
specification should be open enough to apply to other languages as
well (ex. python, ruby).
=back
=head1 VERSION SPECIFICATIONS
Some fields require a version specification (ex. L<"requires">,
L<"recommends">, L<"build_requires">, etc.). This section details the
version specications that are currently supported.
If a single version is listed, then that version is considered to be
the minimum version supported.
If 0 is given as the version number, then any version is supported.
Additionally, for more complicated requirements, the specification
supports a list of versions, each of which may be optionally preceeded
by a relational operator.
Supported operators include E<lt> (less than), E<lt>= (less than or
equal), E<gt> (greater than), E<gt>= (greater than or equal), == (equal), and !=
(not equal).
If a list is given then it is evaluated from left to right so that any
specifications in the list that conflict with a previous specification
are overriden by the later.
Examples:
>= 1.2, != 1.5, < 2.0
Any version from version 1.2 onward, except version 1.5, that also
preceeds version 2.0.
=head1 HEADER
The first line of a F<META.yml> file should be a valid YAML document
header like C<"--- #YAML:1.0">.
=head1 FIELDS
The rest of the F<META.yml> file is one big YAML mapping whose keys
are described here.
=head2 meta-spec
Example:
meta-spec:
version: 1.2
url: http://module-build.sourceforge.net/META-spec-v1.2.html
(Spec 1.1) [required] {URL} This field indicates the location of the
version of the META.yml specification used.
=head2 name
Example:
name: Module-Build
(Spec 1.0) [required] {string} The name of the distribution which is often
created by taking the "main module" in the distribution and changing
"::" to "-". Sometimes it's completely different, however, as in the
case of the libww-perl distribution (see
L<http://search.cpan.org/author/GAAS/libwww-perl/>).
=head2 version
Example:
version: 0.20
(Spec 1.0) [required] {version} The version of the distribution to which the
F<META.yml> file refers.
=head2 abstract
Example:
abstract: Build and install Perl modules.
(Spec 1.1) [required] {string} A short description of the purpose of the
distribution.
=head2 author
Example:
author:
- Ken Williams <kwilliams@cpan.org>
(Spec 1.1) [required] {list of strings} A YAML sequence indicating the author(s) of the
distribution. The prefered form is author-name <email-address>.
=head2 license
Example:
license: perl
(Spec 1.0) [required] {string} The license under which this distribution may be
used and redistributed. See L<Module::Build> for the list of valid
options.
=head2 distribution_type
Example:
distribution_type: module
(Spec 1.0) [optional] {string} What kind of stuff is contained in this
distribution. Most things on CPAN are C<module>s (which can also mean
a collection of modules), but some things are C<script>s.
Unfortunately this field is basically meaningless, since many
distributions are hybrids of several kinds of things, or some new
thing, or subjectively different in focus depending on who's using
them. Tools like Module::Build and MakeMaker will likely stop
generating this field.
=head2 requires
Example:
requires:
Data::Dumper: 0
File::Find: 1.03
(Spec 1.0) [optional] {map} A YAML mapping indicating the Perl modules this
distribution requires for proper operation. The keys are the module
names, and the values are version specifications as described in
L<Module::Build> for the "requires" parameter.
=head2 recommends
Example:
recommends:
Data::Dumper: 0
File::Find: 1.03
(Spec 1.0) [optional] {map} A YAML mapping indicating the Perl modules this
distribution recommends for enhanced operation.
I<ALTERNATIVE: It may be desirable to present to the user which
features depend on which modules so they can make an informed
decision about which recommended modules to install.>
Example:
optional_features:
- foo:
description: Provides the ability to blah.
requires:
Data::Dumper: 0
File::Find: 1.03
- bar:
description: This feature is not available on this platform.
excludes_os: MSWin32
I<(Spec 1.1) [optional] {map} A YAML sequence of names for optional features
which are made available when its requirements are met. For each
feature a description is provided along with any of L<"requires">,
L<"build_requires">, L<"conflicts">, L<"requires_packages">,
L<"requires_os">, and L<"excludes_os"> which have the same meaning in
this subcontext as described elsewhere in this document.>
=head2 build_requires
Example:
build_requires:
Data::Dumper: 0
File::Find: 1.03
(Spec 1.0) [optional] {map} A YAML mapping indicating the Perl modules
required for building and/or testing of this distribution. These
dependencies are not required after the module is installed.
=head2 conflicts
Example:
conflicts:
Data::Dumper: 0
File::Find: 1.03
(Spec 1.0) [optional] {map} A YAML mapping indicating the Perl modules that
cannot be installed while this distribution is installed. This is a
pretty uncommon situation.
=head2 dynamic_config
Example:
dynamic_config: 0
(Spec 1.0) [optional] {boolean} A boolean flag indicating whether a F<Build.PL>
or F<Makefile.PL> (or similar) must be executed when building this
distribution, or whether it can be built, tested and installed solely
from consulting its
metadata file. The main reason to set this to a true value if that
your module performs some dynamic configuration (asking questions,
sensing the environment, etc.) as part of its build/install process.
Currently Module::Build doesn't actually do anything with this flag
- it's probably going to be up to higher-level tools like CPAN
to do something useful with it. It can potentially bring lots of
security, packaging, and convenience improvements.
If this field is omitted, it defaults to 1 (true).
=head2 private
I<(Deprecated)> (Spec 1.0) [optional] {map} This field has been renamed to
L</"no_index">. See below.
=head2 provides
Example:
provides:
Foo::Bar:
file: lib/Foo/Bar.pm
version: 0.27_02
Foo::Bar::Blah:
file: lib/Foo/Bar/Blah.pm
Foo::Bar::Baz:
file: lib/Foo/Bar/Baz.pm
version: 0.3
(Spec 1.1) [optional] {map} A YAML mapping that describes all packages
provided by this distribution. This information can be (and, in some
cases, is) used by distribution and automation mechanisms like PAUSE,
CPAN, and search.cpan.org to build indexes saying in which
distribution various packages can be found.
When using tools like C<Module::Build> that can generate the
C<provides> mapping for your distribution automatically, make sure you
examine what it generates to make sure it makes sense - indexers will
usually trust the C<provides> field if it's present, rather than
scanning through the distribution files themselves to figure out
packages and versions. This is a good thing, because it means you can
use the C<provides> field to tell the indexers precisely what you want
indexed about your distribution, rather than relying on them to
essentially guess what you want indexed.
=head2 no_index
Example:
no_index:
file:
- My/Module.pm
dir:
- My/Private
package:
- My::Module::Stuff
namespace:
- My::Module::Stuff
(Spec 1.1) [optional] {map} A YAML mapping that describes any files,
directories, packages, and namespaces that are private
(i.e. implementation artifacts) that are not of interest to searching
and indexing tools. This is useful when no C<provides> field is
present.
I<(Note: I'm not actually sure who looks at this field, or exactly
what they do with it. This spec could be off in some way from actual
usage.)>
=head3 file
(Spec 1.1) [optional] Exclude any listed file(s).
=head3 dir
(Spec 1.1) [optional] Exclude anything below the listed
directory(ies).
=head3 package
(Spec 1.1) [optional] Exclude the listed package(s).
=head3 namespace
(Spec 1.1) [optional] Excludes anything below the listed namespace(s),
but I<not> the listed namespace(s) its self.
=head2 keywords
Example:
keywords:
- make
- build
- install
(Spec 1.1) [optional] {list} A sequence of keywords/phrases that describe
this distribution.
=head2 resources
Example:
resources:
license: http://dev.perl.org/licenses/
homepage: http://sourceforge.net/projects/module-build
bugtracker: http://rt.cpan.org/NoAuth/Bugs.html?Dist=Module-Build
MailingList: http://lists.sourceforge.net/lists/listinfo/module-build-general
(Spec 1.1) [optional] {map} A mapping of any URL resources related to
this distribution. All-lower-case keys, such as C<homepage>,
C<license>, and C<bugtracker>, are reserved by this specification, as
they have "official" meanings defined here in this specification. If
you'd like to add your own "special" entries (like the "MailingList"
entry above), use at least one upper-case letter.
The current set of official keys is:
=over 2
=item homepage
The official home of this project on the web.
=item license
An URL for an official statement of this distribution's license.
=item bugtracker
An URL for a bug tracker (e.g. Bugzilla or RT queue) for this project.
=back
=head2 generated_by
Example:
generated_by: Module::Build version 0.20
(Spec 1.0) [required] {string} Indicates the tool that was used to create this
F<META.yml> file. It's good form to include both the name of the tool
and its version, but this field is essentially opaque, at least for
the moment. If F<META.yml> was generated by hand, it is suggested that
the author be specified here.
[Note: My F<meta_stats.pl> script which I use to gather statistics
regarding F<META.yml> usage prefers the form listed above, i.e. it
splits on /\s+version\s+/ taking the first field as the name of the
tool that generated the file and the second field as version of that
tool. RWS]
=head1 SEE ALSO
CPAN, L<http://www.cpan.org/>
CPAN.pm, L<http://search.cpan.org/author/ANDK/CPAN/>
CPANPLUS, L<http://search.cpan.org/author/KANE/CPANPLUS/>
Data::Dumper, L<http://search.cpan.org/author/ILYAM/Data-Dumper/>
ExtUtils::MakeMaker, L<http://search.cpan.org/author/MSCHWERN/ExtUtils-MakeMaker/>
Module::Build, L<http://search.cpan.org/author/KWILLIAMS/Module-Build/>
Module::Install, L<http://search.cpan.org/author/KWILLIAMS/Module-Install/>
XML, L<http://www.w3.org/XML/>
YAML, L<http://www.yaml.org/>
=head1 HISTORY
=over 4
=item March 14, 2003 (Pi day)
=over 2
=item *
Created version 1.0 of this document.
=back
=item May 8, 2003
=over 2
=item *
Added the L</"dynamic_config"> field, which was missing from the initial
version.
=back
=item November 13, 2003
=over 2
=item *
Added more YAML rationale articles.
=item *
Fixed existing link to YAML discussion thread to point to new
L<http://nntp.x.perl.org/group/> site.
=item *
Added and deprecated the L<"private"> field.
=item *
Added L<"abstract">, L<"configure">, L<"requires_packages">,
L<"requires_os">, L<"excludes_os">, and L<"no_index"> fields.
=item *
Bumped version.
=back
=item November 16, 2003
=over 2
=item *
Added L<"generation">, L<"authored_by"> fields.
=item *
Add alternative proposal to the L<"recommends"> field.
=item *
Add proposal for a L<"requires_build_tools"> field.
=back
=item December 9, 2003
=over 2
=item *
Added link to latest version of this specification on CPAN.
=item *
Added section L<"VERSION SPECIFICATIONS">.
=item *
Chang name from Module::Build::META-spec to CPAN::META::Specification.
=item *
Add proposal for L<"auto_regenerate"> field.
=back
=item December 15, 2003
=over 2
=item *
Add L<"index"> field as a compliment to L<"no_index">
=item *
Add L<"keywords"> field as a means to aid searching distributions.
=item *
Add L<"TERMINOLOGY"> section to explain certain terms that may be
ambiguous.
=back
=item July 26, 2005
=over 2
=item *
Removed a bunch of items (generation, requires_build_tools,
requires_packages, configure, requires_os, excludes_os,
auto_regenerate) that have never actually been supported, but were
more like records of brainstorming.
=item *
Changed C<authored_by> to C<author>, since that's always been what
it's actually called in actual F<META.yml> files.
=item *
Added the "==" operator to the list of supported version-checking
operators.
=item *
Noted that the C<distribution_type> field is basically meaningless,
and shouldn't really be used.
=item *
Clarified C<dynamic_config> a bit.
=back
=item August 23, 2005
=over 2
=item *
Removed the name C<CPAN::META::Specification>, since that implies a
module that doesn't actually exist.
=back
=back
history/META-spec-1_3.pod 0000644 00000037660 15170246504 0011027 0 ustar 00 =head1 NAME
META-spec - Specification for F<META.yml> documents
=head1 SYNOPSIS
--- #YAML:1.0
name: Module-Build
abstract: Build and install Perl modules
version: 0.20
author:
- Ken Williams <kwilliams@cpan.org>
license: perl
distribution_type: module
requires:
Config: 0
Cwd: 0
Data::Dumper: 0
ExtUtils::Install: 0
File::Basename: 0
File::Compare: 0
File::Copy: 0
File::Find: 0
File::Path: 0
File::Spec: 0
IO::File: 0
perl: 5.005_03
recommends:
Archive::Tar: 1.00
ExtUtils::Install: 0.3
ExtUtils::ParseXS: 2.02
Pod::Text: 0
YAML: 0.35
build_requires:
Test: 0
urls:
license: http://dev.perl.org/licenses/
meta-spec:
version: 1.3
url: http://module-build.sourceforge.net/META-spec-v1.3.html
generated_by: Module::Build version 0.20
=head1 DESCRIPTION
This document describes version 1.3 of the F<META.yml> specification.
The F<META.yml> file describes important properties of contributed
Perl distributions such as the ones found on CPAN. It is typically
created by tools like Module::Build, Module::Install, and
ExtUtils::MakeMaker.
The fields in the F<META.yml> file are meant to be helpful for people
maintaining module collections (like CPAN), for people writing
installation tools (like CPAN.pm or CPANPLUS), or just for people who
want to know some stuff about a distribution before downloading it and
starting to install it.
I<Note: The latest stable version of this specification can always be
found at L<http://module-build.sourceforge.net/META-spec-current.html>,
and the latest development version (which may include things that
won't make it into the stable version) can always be found at
L<http://module-build.sourceforge.net/META-spec-blead.html>.>
=head1 FORMAT
F<META.yml> files are written in the YAML format (see
L<http://www.yaml.org/>).
See the following links to learn why we chose YAML instead of, say,
XML or Data::Dumper:
=over 4
=item Module::Build design plans
L<http://nntp.x.perl.org/group/perl.makemaker/406>
=item Not keen on YAML
L<http://nntp.x.perl.org/group/perl.module-authors/1353>
=item META Concerns
L<http://nntp.x.perl.org/group/perl.module-authors/1385>
=back
=head1 TERMINOLOGY
=over 4
=item distribution
This is the primary object described by the F<META.yml>
specification. In the context of this document it usually refers to a
collection of modules, scripts, and/or documents that are distributed
together for other developers to use. Examples of distributions are
C<Class-Container>, C<libwww-perl>, or C<DBI>.
=item module
This refers to a reusable library of code typically contained in a
single file. Currently, we primarily talk of perl modules, but this
specification should be open enough to apply to other languages as
well (ex. python, ruby). Examples of modules are C<Class::Container>,
C<LWP::Simple>, or C<DBD::File>.
=back
=head1 HEADER
The first line of a F<META.yml> file should be a valid YAML document
header like C<"--- #YAML:1.0">.
=head1 FIELDS
The rest of the F<META.yml> file is one big YAML mapping whose keys
are described here.
=head2 meta-spec
Example:
meta-spec:
version: 1.3
url: http://module-build.sourceforge.net/META-spec-v1.3.html
(Spec 1.1) [required] {URL} This field indicates the location of the
version of the META.yml specification used.
=head2 name
Example:
name: Module-Build
(Spec 1.0) [required] {string} The name of the distribution which is often
created by taking the "main module" in the distribution and changing
"::" to "-". Sometimes it's completely different, however, as in the
case of the libww-perl distribution (see
L<http://search.cpan.org/dist/libwww-perl/>).
=head2 version
Example:
version: 0.20
(Spec 1.0) [required] {version} The version of the distribution to which the
F<META.yml> file refers.
=head2 abstract
Example:
abstract: Build and install Perl modules.
(Spec 1.1) [required] {string} A short description of the purpose of the
distribution.
=head2 author
Example:
author:
- Ken Williams <kwilliams@cpan.org>
(Spec 1.1) [required] {list of strings} A YAML sequence indicating the author(s) of the
distribution. The prefered form is author-name <email-address>.
=head2 license
Example:
license: perl
(Spec 1.0) [required] {string} The license under which this distribution may be
used and redistributed. See L<Module::Build> for the list of valid
options.
=head2 distribution_type
Example:
distribution_type: module
(Spec 1.0) [optional] {string} What kind of stuff is contained in this
distribution. Most things on CPAN are C<module>s (which can also mean
a collection of modules), but some things are C<script>s.
Unfortunately this field is basically meaningless, since many
distributions are hybrids of several kinds of things, or some new
thing, or subjectively different in focus depending on who's using
them. Tools like Module::Build and MakeMaker will likely stop
generating this field.
=head2 requires
Example:
requires:
Data::Dumper: 0
File::Find: 1.03
(Spec 1.0) [optional] {map} A YAML mapping indicating the Perl modules this
distribution requires for proper operation. The keys are the module
names, and the values are version specifications as described in
L<VERSION SPECIFICATIONS>.
=head2 recommends
Example:
recommends:
Data::Dumper: 0
File::Find: 1.03
(Spec 1.0) [optional] {map} A YAML mapping indicating the Perl modules
this distribution recommends for enhanced operation. The keys are the
module names, and the values are version specifications as described
in L<VERSION SPECIFICATIONS>.
I<ALTERNATIVE: It may be desirable to present to the user which
features depend on which modules so they can make an informed decision
about which recommended modules to install.>
Example:
optional_features:
- foo:
description: Provides the ability to blah.
requires:
Data::Dumper: 0
File::Find: 1.03
- bar:
description: This feature is not available on this platform.
excludes_os: MSWin32
I<(Spec 1.1) [optional] {map} A YAML sequence of names for optional features
which are made available when its requirements are met. For each
feature a description is provided along with any of L<"requires">,
L<"build_requires">, L<"conflicts">, L<"requires_packages">,
L<"requires_os">, and L<"excludes_os"> which have the same meaning in
this subcontext as described elsewhere in this document.>
=head2 build_requires
Example:
build_requires:
Data::Dumper: 0
File::Find: 1.03
(Spec 1.0) [optional] {map} A YAML mapping indicating the Perl modules
required for building and/or testing of this distribution. The keys
are the module names, and the values are version specifications as
described in L<VERSION SPECIFICATIONS>. These dependencies are not
required after the module is installed.
=head2 conflicts
Example:
conflicts:
Data::Dumper: 0
File::Find: 1.03
(Spec 1.0) [optional] {map} A YAML mapping indicating the Perl modules that
cannot be installed while this distribution is installed. This is a
pretty uncommon situation. The keys for C<conflicts> are the module
names, and the values are version specifications as described in
L<VERSION SPECIFICATIONS>.
=head2 dynamic_config
Example:
dynamic_config: 0
(Spec 1.0) [optional] {boolean} A boolean flag indicating whether a F<Build.PL>
or F<Makefile.PL> (or similar) must be executed when building this
distribution, or whether it can be built, tested and installed solely
from consulting its
metadata file. The main reason to set this to a true value is that
your module performs some dynamic configuration (asking questions,
sensing the environment, etc.) as part of its build/install process.
Currently Module::Build doesn't actually do anything with this flag
- it's probably going to be up to higher-level tools like CPAN
to do something useful with it. It can potentially bring lots of
security, packaging, and convenience improvements.
If this field is omitted, it defaults to 1 (true).
=head2 private
I<(Deprecated)> (Spec 1.0) [optional] {map} This field has been renamed to
L</"no_index">. See below.
=head2 provides
Example:
provides:
Foo::Bar:
file: lib/Foo/Bar.pm
version: 0.27_02
Foo::Bar::Blah:
file: lib/Foo/Bar/Blah.pm
Foo::Bar::Baz:
file: lib/Foo/Bar/Baz.pm
version: 0.3
(Spec 1.1) [optional] {map} A YAML mapping that describes all packages
provided by this distribution. This information can be (and, in some
cases, is) used by distribution and automation mechanisms like PAUSE,
CPAN, and search.cpan.org to build indexes saying in which
distribution various packages can be found.
When using tools like C<Module::Build> that can generate the
C<provides> mapping for your distribution automatically, make sure you
examine what it generates to make sure it makes sense - indexers will
usually trust the C<provides> field if it's present, rather than
scanning through the distribution files themselves to figure out
packages and versions. This is a good thing, because it means you can
use the C<provides> field to tell the indexers precisely what you want
indexed about your distribution, rather than relying on them to
essentially guess what you want indexed.
=head2 no_index
Example:
no_index:
file:
- My/Module.pm
directory:
- My/Private
package:
- My::Module::Stuff
namespace:
- My::Module::Stuff
(Spec 1.1) [optional] {map} A YAML mapping that describes any files,
directories, packages, and namespaces that are private
(i.e. implementation artifacts) that are not of interest to searching
and indexing tools. This is useful when no C<provides> field is
present.
For example, C<search.cpan.org> excludes items listed in C<no_index>
when searching for POD, meaning files in these directories will not
converted to HTML and made public - which is useful if you have
example or test PODs that you don't want the search engine to go
through.
=head3 file
(Spec 1.1) [optional] Exclude any listed file(s).
=head3 directory
(Spec 1.1) [optional] Exclude anything below the listed
directory(ies).
[Note: previous editions of the spec had C<dir> instead of
C<directory>, but I think MakeMaker and various users started using
C<directory>, so in deference we switched to that.]
=head3 package
(Spec 1.1) [optional] Exclude the listed package(s).
=head3 namespace
(Spec 1.1) [optional] Excludes anything below the listed namespace(s),
but I<not> the listed namespace(s) its self.
=head2 keywords
Example:
keywords:
- make
- build
- install
(Spec 1.1) [optional] {list} A sequence of keywords/phrases that describe
this distribution.
=head2 resources
Example:
resources:
license: http://dev.perl.org/licenses/
homepage: http://sourceforge.net/projects/module-build
bugtracker: http://rt.cpan.org/NoAuth/Bugs.html?Dist=Module-Build
repository: http://sourceforge.net/cvs/?group_id=45731
MailingList: http://lists.sourceforge.net/lists/listinfo/module-build-general
(Spec 1.1) [optional] {map} A mapping of any URL resources related to
this distribution. All-lower-case keys, such as C<homepage>,
C<license>, and C<bugtracker>, are reserved by this specification, as
they have "official" meanings defined here in this specification. If
you'd like to add your own "special" entries (like the "MailingList"
entry above), use at least one upper-case letter.
The current set of official keys is:
=over 2
=item homepage
The official home of this project on the web.
=item license
An URL for an official statement of this distribution's license.
=item bugtracker
An URL for a bug tracker (e.g. Bugzilla or RT queue) for this project.
=back
=head2 generated_by
Example:
generated_by: Module::Build version 0.20
(Spec 1.0) [required] {string} Indicates the tool that was used to create this
F<META.yml> file. It's good form to include both the name of the tool
and its version, but this field is essentially opaque, at least for
the moment. If F<META.yml> was generated by hand, it is suggested that
the author be specified here.
[Note: My F<meta_stats.pl> script which I use to gather statistics
regarding F<META.yml> usage prefers the form listed above, i.e. it
splits on /\s+version\s+/ taking the first field as the name of the
tool that generated the file and the second field as version of that
tool. RWS]
=head1 VERSION SPECIFICATIONS
Some fields require a version specification (ex. L<"requires">,
L<"recommends">, L<"build_requires">, etc.) to indicate the particular
versionZ<>(s) of some other module that may be required as a
prerequisite. This section details the version specification formats
that are currently supported.
The simplest format for a version specification is just the version
number itself, e.g. C<2.4>. This means that B<at least> version 2.4
must be present. To indicate that B<any> version of a prerequisite is
okay, even if the prerequisite doesn't define a version at all, use
the version C<0>.
You may also use the operators E<lt> (less than), E<lt>= (less than or
equal), E<gt> (greater than), E<gt>= (greater than or equal), ==
(equal), and != (not equal). For example, the specification C<E<lt>
2.0> means that any version of the prerequisite less than 2.0 is
suitable.
For more complicated situations, version specifications may be AND-ed
together using commas. The specification C<E<gt>= 1.2, != 1.5, E<lt>
2.0> indicates a version that must be B<at least> 1.2, B<less than>
2.0, and B<not equal to> 1.5.
=head1 SEE ALSO
CPAN, L<http://www.cpan.org/>
CPAN.pm, L<http://search.cpan.org/dist/CPAN/>
CPANPLUS, L<http://search.cpan.org/dist/CPANPLUS/>
Data::Dumper, L<http://search.cpan.org/dist/Data-Dumper/>
ExtUtils::MakeMaker, L<http://search.cpan.org/dist/ExtUtils-MakeMaker/>
Module::Build, L<http://search.cpan.org/dist/Module-Build/>
Module::Install, L<http://search.cpan.org/dist/Module-Install/>
XML, L<http://www.w3.org/XML/>
YAML, L<http://www.yaml.org/>
=head1 HISTORY
=over 4
=item March 14, 2003 (Pi day)
=over 2
=item *
Created version 1.0 of this document.
=back
=item May 8, 2003
=over 2
=item *
Added the L</"dynamic_config"> field, which was missing from the initial
version.
=back
=item November 13, 2003
=over 2
=item *
Added more YAML rationale articles.
=item *
Fixed existing link to YAML discussion thread to point to new
L<http://nntp.x.perl.org/group/> site.
=item *
Added and deprecated the L<"private"> field.
=item *
Added L<"abstract">, L<"configure">, L<"requires_packages">,
L<"requires_os">, L<"excludes_os">, and L<"no_index"> fields.
=item *
Bumped version.
=back
=item November 16, 2003
=over 2
=item *
Added L<"generation">, L<"authored_by"> fields.
=item *
Add alternative proposal to the L<"recommends"> field.
=item *
Add proposal for a L<"requires_build_tools"> field.
=back
=item December 9, 2003
=over 2
=item *
Added link to latest version of this specification on CPAN.
=item *
Added section L<"VERSION SPECIFICATIONS">.
=item *
Chang name from Module::Build::META-spec to CPAN::META::Specification.
=item *
Add proposal for L<"auto_regenerate"> field.
=back
=item December 15, 2003
=over 2
=item *
Add L<"index"> field as a compliment to L<"no_index">
=item *
Add L<"keywords"> field as a means to aid searching distributions.
=item *
Add L<"TERMINOLOGY"> section to explain certain terms that may be
ambiguous.
=back
=item July 26, 2005
=over 2
=item *
Removed a bunch of items (generation, requires_build_tools,
requires_packages, configure, requires_os, excludes_os,
auto_regenerate) that have never actually been supported, but were
more like records of brainstorming.
=item *
Changed C<authored_by> to C<author>, since that's always been what
it's actually called in actual F<META.yml> files.
=item *
Added the "==" operator to the list of supported version-checking
operators.
=item *
Noted that the C<distribution_type> field is basically meaningless,
and shouldn't really be used.
=item *
Clarified C<dynamic_config> a bit.
=back
=item August 23, 2005
=over 2
=item *
Removed the name C<CPAN::META::Specification>, since that implies a
module that doesn't actually exist.
=back
=back
history/META-spec-1_4.pod 0000644 00000043512 15170246504 0011021 0 ustar 00 =head1 NAME
META-spec - Specification for F<META.yml> documents
=head1 SYNOPSIS
--- #YAML:1.0
name: Module-Build
abstract: Build and install Perl modules
version: 0.20
author:
- Ken Williams <kwilliams@cpan.org>
license: perl
distribution_type: module
requires:
Config: 0
Cwd: 0
Data::Dumper: 0
ExtUtils::Install: 0
File::Basename: 0
File::Compare: 0
File::Copy: 0
File::Find: 0
File::Path: 0
File::Spec: 0
IO::File: 0
perl: 5.005_03
recommends:
Archive::Tar: 1.00
ExtUtils::Install: 0.3
ExtUtils::ParseXS: 2.02
Pod::Text: 0
YAML: 0.35
build_requires:
Test: 0
resources:
license: http://dev.perl.org/licenses/
meta-spec:
version: 1.4
url: http://module-build.sourceforge.net/META-spec-v1.3.html
generated_by: Module::Build version 0.20
=head1 DESCRIPTION
This document describes version 1.4 of the F<META.yml> specification.
The F<META.yml> file describes important properties of contributed
Perl distributions such as the ones found on CPAN. It is typically
created by tools like Module::Build, Module::Install, and
ExtUtils::MakeMaker.
The fields in the F<META.yml> file are meant to be helpful for people
maintaining module collections (like CPAN), for people writing
installation tools (like CPAN.pm or CPANPLUS), or just for people who
want to know some stuff about a distribution before downloading it and
starting to install it.
I<Note: The latest stable version of this specification can always be
found at L<http://module-build.sourceforge.net/META-spec-current.html>,
and the latest development version (which may include things that
won't make it into the stable version) can always be found at
L<http://module-build.sourceforge.net/META-spec-blead.html>.>
=begin MAINTAINER
The master source for the META spec is META-spec.pod. META-spec.html
is built (manually) from META-spec.pod whenever there are changes, and
the two files should generally be checked in together. Ideally it
would happen through a trigger or something, but it doesn't.
Ken has a cron job that copies the latest bleeding-edge version of the
spec (HTML version) to Sourceforge whenever his laptop is turned on:
21 * * * * svn cat http://svn.perl.org/modules/Module-Build/trunk/website/META-spec.html \
| ssh kwilliams@shell.sourceforge.net \
'cat > /home/groups/m/mo/module-build/htdocs/META-spec-blead.html'
The numbered revisions of the spec at
L<"http://module-build.sourceforge.net/"> are captures of the spec at
opportune moments. A couple of symlinks also exist for convenience:
-rw-r--r-- 1 kwilliams 24585 Oct 10 17:21 META-spec-blead.html
lrwxrwxrwx 1 kwilliams 19 Jan 19 2007 META-spec-current.html -> META-spec-v1.3.html
lrwxrwxrwx 1 kwilliams 22 Jan 19 2007 META-spec.html -> META-spec-current.html
-rw-r--r-- 1 kwilliams 5830 Jul 25 2005 META-spec-v1.0.html
-rw-r--r-- 1 kwilliams 7847 Jul 25 2005 META-spec-v1.1.html
-rw-r--r-- 1 kwilliams 22635 Aug 23 2005 META-spec-v1.2.html
-rw-r--r-- 1 kwilliams 24086 Nov 4 2006 META-spec-v1.3.html
=end MAINTAINER
=head1 FORMAT
F<META.yml> files are written in the YAML format (see
L<http://www.yaml.org/>).
See the following links to learn why we chose YAML instead of, say,
XML or Data::Dumper:
=over 4
=item Module::Build design plans
L<http://nntp.x.perl.org/group/perl.makemaker/406>
=item Not keen on YAML
L<http://nntp.x.perl.org/group/perl.module-authors/1353>
=item META Concerns
L<http://nntp.x.perl.org/group/perl.module-authors/1385>
=back
=head1 TERMINOLOGY
=over 4
=item distribution
This is the primary object described by the F<META.yml>
specification. In the context of this document it usually refers to a
collection of modules, scripts, and/or documents that are distributed
together for other developers to use. Examples of distributions are
C<Class-Container>, C<libwww-perl>, or C<DBI>.
=item module
This refers to a reusable library of code typically contained in a
single file. Currently, we primarily talk of perl modules, but this
specification should be open enough to apply to other languages as
well (ex. python, ruby). Examples of modules are C<Class::Container>,
C<LWP::Simple>, or C<DBD::File>.
=back
=head1 HEADER
The first line of a F<META.yml> file should be a valid YAML document
header like C<"--- #YAML:1.0">.
=head1 FIELDS
The rest of the F<META.yml> file is one big YAML mapping whose keys
are described here.
=head2 meta-spec
Example:
meta-spec:
version: 1.4
url: http://module-build.sourceforge.net/META-spec-v1.3.html
(Spec 1.1) [required] {URL} This field indicates the location of the
version of the META.yml specification used.
=head2 name
Example:
name: Module-Build
(Spec 1.0) [required] {string} The name of the distribution which is often
created by taking the "main module" in the distribution and changing
"::" to "-". Sometimes it's completely different, however, as in the
case of the libww-perl distribution (see
L<http://search.cpan.org/dist/libwww-perl/>).
=head2 version
Example:
version: 0.20
(Spec 1.0) [required] {version} The version of the distribution to which the
F<META.yml> file refers.
=head2 abstract
Example:
abstract: Build and install Perl modules.
(Spec 1.1) [required] {string} A short description of the purpose of the
distribution.
=head2 author
Example:
author:
- Ken Williams <kwilliams@cpan.org>
(Spec 1.1) [required] {list of strings} A YAML sequence indicating the author(s) of the
distribution. The prefered form is author-name <email-address>.
=head2 license
Example:
license: perl
(Spec 1.0) [required] {string} The license under which this
distribution may be used and redistributed. See
L<http://search.cpan.org/dist/Module-Build/lib/Module/Build/API.pod>
for the list of valid options.
=head2 distribution_type
Example:
distribution_type: module
(Spec 1.0) [optional] {string} What kind of stuff is contained in this
distribution. Most things on CPAN are C<module>s (which can also mean
a collection of modules), but some things are C<script>s.
Unfortunately this field is basically meaningless, since many
distributions are hybrids of several kinds of things, or some new
thing, or subjectively different in focus depending on who's using
them. Tools like Module::Build and MakeMaker will likely stop
generating this field.
=head2 requires
Example:
requires:
Data::Dumper: 0
File::Find: 1.03
(Spec 1.0) [optional] {map} A YAML mapping indicating the Perl
prerequisites this distribution requires for proper operation. The
keys are the names of the prerequisites (module names or 'perl'), and
the values are version specifications as described in L<VERSION
SPECIFICATIONS>.
=head2 recommends
Example:
recommends:
Data::Dumper: 0
File::Find: 1.03
(Spec 1.0) [optional] {map} A YAML mapping indicating the Perl
prerequisites this distribution recommends for enhanced operation.
The keys are the names of the prerequisites (module names or 'perl'),
and the values are version specifications as described in L<VERSION
SPECIFICATIONS>.
I<ALTERNATIVE: It may be desirable to present to the user which
features depend on which modules so they can make an informed decision
about which recommended modules to install.>
Example:
optional_features:
foo:
description: Provides the ability to blah.
requires:
Data::Dumper: 0
File::Find: 1.03
I<(Spec 1.1) [optional] {map} A YAML mapping of names for optional features
which are made available when its requirements are met. For each
feature a description is provided along with any of L<"requires">,
L<"build_requires">, and L<"conflicts">, which have the same meaning in
this subcontext as described elsewhere in this document.>
=head2 build_requires
Example:
build_requires:
Data::Dumper: 0
File::Find: 1.03
(Spec 1.0) [optional] {map} A YAML mapping indicating the Perl
prerequisites required for building and/or testing of this
distribution. The keys are the names of the prerequisites (module
names or 'perl'), and the values are version specifications as
described in L<VERSION SPECIFICATIONS>. These dependencies are not
required after the distribution is installed.
=head2 configure_requires
Example:
configure_requires:
Module::Build: 0.2809
Data::Dumper: 0
File::Find: 1.03
(Spec 1.4) [optional] {map} A YAML mapping indicating the Perl prerequisites
required before configuring this distribution. The keys are the
names of the prerequisites (module names or 'perl'), and the values are version specifications as described
in L<VERSION SPECIFICATIONS>. These dependencies are not required
after the distribution is installed.
=head2 conflicts
Example:
conflicts:
Data::Dumper: 0
File::Find: 1.03
(Spec 1.0) [optional] {map} A YAML mapping indicating any items that
cannot be installed while this distribution is installed. This is a
pretty uncommon situation. The keys for C<conflicts> are the item
names (module names or 'perl'), and the values are version
specifications as described in L<VERSION SPECIFICATIONS>.
=head2 dynamic_config
Example:
dynamic_config: 0
(Spec 1.0) [optional] {boolean} A boolean flag indicating whether a F<Build.PL>
or F<Makefile.PL> (or similar) must be executed when building this
distribution, or whether it can be built, tested and installed solely
from consulting its
metadata file. The main reason to set this to a true value is that
your module performs some dynamic configuration (asking questions,
sensing the environment, etc.) as part of its build/install process.
Currently Module::Build doesn't actually do anything with this flag
- it's probably going to be up to higher-level tools like CPAN
to do something useful with it. It can potentially bring lots of
security, packaging, and convenience improvements.
If this field is omitted, it defaults to 1 (true).
=head2 private
I<(Deprecated)> (Spec 1.0) [optional] {map} This field has been renamed to
L</"no_index">. See below.
=head2 provides
Example:
provides:
Foo::Bar:
file: lib/Foo/Bar.pm
version: 0.27_02
Foo::Bar::Blah:
file: lib/Foo/Bar/Blah.pm
Foo::Bar::Baz:
file: lib/Foo/Bar/Baz.pm
version: 0.3
(Spec 1.1) [optional] {map} A YAML mapping that describes all packages
provided by this distribution. This information can be (and, in some
cases, is) used by distribution and automation mechanisms like PAUSE,
CPAN, and search.cpan.org to build indexes saying in which
distribution various packages can be found.
When using tools like C<Module::Build> that can generate the
C<provides> mapping for your distribution automatically, make sure you
examine what it generates to make sure it makes sense - indexers will
usually trust the C<provides> field if it's present, rather than
scanning through the distribution files themselves to figure out
packages and versions. This is a good thing, because it means you can
use the C<provides> field to tell the indexers precisely what you want
indexed about your distribution, rather than relying on them to
essentially guess what you want indexed.
=head2 no_index
Example:
no_index:
file:
- My/Module.pm
directory:
- My/Private
package:
- My::Module::Stuff
namespace:
- My::Module::Stuff
(Spec 1.1) [optional] {map} A YAML mapping that describes any files,
directories, packages, and namespaces that are private
(i.e. implementation artifacts) that are not of interest to searching
and indexing tools. This is useful when no C<provides> field is
present.
For example, C<search.cpan.org> excludes items listed in C<no_index>
when searching for POD, meaning files in these directories will not
converted to HTML and made public - which is useful if you have
example or test PODs that you don't want the search engine to go
through.
=head3 file
(Spec 1.1) [optional] Exclude any listed file(s).
=head3 directory
(Spec 1.1) [optional] Exclude anything below the listed
directory(ies).
[Note: previous editions of the spec had C<dir> instead of
C<directory>, but I think MakeMaker and various users started using
C<directory>, so in deference we switched to that.]
=head3 package
(Spec 1.1) [optional] Exclude the listed package(s).
=head3 namespace
(Spec 1.1) [optional] Excludes anything below the listed namespace(s),
but I<not> the listed namespace(s) its self.
=head2 keywords
Example:
keywords:
- make
- build
- install
(Spec 1.1) [optional] {list} A sequence of keywords/phrases that describe
this distribution.
=head2 resources
Example:
resources:
license: http://dev.perl.org/licenses/
homepage: http://sourceforge.net/projects/module-build
bugtracker: http://rt.cpan.org/NoAuth/Bugs.html?Dist=Module-Build
repository: http://sourceforge.net/cvs/?group_id=45731
MailingList: http://lists.sourceforge.net/lists/listinfo/module-build-general
(Spec 1.1) [optional] {map} A mapping of any URL resources related to
this distribution. All-lower-case keys, such as C<homepage>,
C<license>, and C<bugtracker>, are reserved by this specification, as
they have "official" meanings defined here in this specification. If
you'd like to add your own "special" entries (like the "MailingList"
entry above), use at least one upper-case letter.
The current set of official keys is:
=over 2
=item homepage
The official home of this project on the web.
=item license
An URL for an official statement of this distribution's license.
=item bugtracker
An URL for a bug tracker (e.g. Bugzilla or RT queue) for this project.
=back
=head2 generated_by
Example:
generated_by: Module::Build version 0.20
(Spec 1.0) [required] {string} Indicates the tool that was used to create this
F<META.yml> file. It's good form to include both the name of the tool
and its version, but this field is essentially opaque, at least for
the moment. If F<META.yml> was generated by hand, it is suggested that
the author be specified here.
[Note: My F<meta_stats.pl> script which I use to gather statistics
regarding F<META.yml> usage prefers the form listed above, i.e. it
splits on /\s+version\s+/ taking the first field as the name of the
tool that generated the file and the second field as version of that
tool. RWS]
=head1 VERSION SPECIFICATIONS
Some fields require a version specification (ex. L<"requires">,
L<"recommends">, L<"build_requires">, etc.) to indicate the particular
versionZ<>(s) of some other module that may be required as a
prerequisite. This section details the version specification formats
that are currently supported.
The simplest format for a version specification is just the version
number itself, e.g. C<2.4>. This means that B<at least> version 2.4
must be present. To indicate that B<any> version of a prerequisite is
okay, even if the prerequisite doesn't define a version at all, use
the version C<0>.
You may also use the operators E<lt> (less than), E<lt>= (less than or
equal), E<gt> (greater than), E<gt>= (greater than or equal), ==
(equal), and != (not equal). For example, the specification C<E<lt>
2.0> means that any version of the prerequisite less than 2.0 is
suitable.
For more complicated situations, version specifications may be AND-ed
together using commas. The specification C<E<gt>= 1.2, != 1.5, E<lt>
2.0> indicates a version that must be B<at least> 1.2, B<less than>
2.0, and B<not equal to> 1.5.
=head1 SEE ALSO
CPAN, L<http://www.cpan.org/>
CPAN.pm, L<http://search.cpan.org/dist/CPAN/>
CPANPLUS, L<http://search.cpan.org/dist/CPANPLUS/>
Data::Dumper, L<http://search.cpan.org/dist/Data-Dumper/>
ExtUtils::MakeMaker, L<http://search.cpan.org/dist/ExtUtils-MakeMaker/>
Module::Build, L<http://search.cpan.org/dist/Module-Build/>
Module::Install, L<http://search.cpan.org/dist/Module-Install/>
XML, L<http://www.w3.org/XML/>
YAML, L<http://www.yaml.org/>
=head1 HISTORY
=over 4
=item March 14, 2003 (Pi day)
=over 2
=item *
Created version 1.0 of this document.
=back
=item May 8, 2003
=over 2
=item *
Added the L</"dynamic_config"> field, which was missing from the initial
version.
=back
=item November 13, 2003
=over 2
=item *
Added more YAML rationale articles.
=item *
Fixed existing link to YAML discussion thread to point to new
L<http://nntp.x.perl.org/group/> site.
=item *
Added and deprecated the L<"private"> field.
=item *
Added L<"abstract">, L<"configure">, L<"requires_packages">,
L<"requires_os">, L<"excludes_os">, and L<"no_index"> fields.
=item *
Bumped version.
=back
=item November 16, 2003
=over 2
=item *
Added L<"generation">, L<"authored_by"> fields.
=item *
Add alternative proposal to the L<"recommends"> field.
=item *
Add proposal for a L<"requires_build_tools"> field.
=back
=item December 9, 2003
=over 2
=item *
Added link to latest version of this specification on CPAN.
=item *
Added section L<"VERSION SPECIFICATIONS">.
=item *
Chang name from Module::Build::META-spec to CPAN::META::Specification.
=item *
Add proposal for L<"auto_regenerate"> field.
=back
=item December 15, 2003
=over 2
=item *
Add L<"index"> field as a compliment to L<"no_index">
=item *
Add L<"keywords"> field as a means to aid searching distributions.
=item *
Add L<"TERMINOLOGY"> section to explain certain terms that may be
ambiguous.
=back
=item July 26, 2005
=over 2
=item *
Removed a bunch of items (generation, requires_build_tools,
requires_packages, configure, requires_os, excludes_os,
auto_regenerate) that have never actually been supported, but were
more like records of brainstorming.
=item *
Changed C<authored_by> to C<author>, since that's always been what
it's actually called in actual F<META.yml> files.
=item *
Added the "==" operator to the list of supported version-checking
operators.
=item *
Noted that the C<distribution_type> field is basically meaningless,
and shouldn't really be used.
=item *
Clarified C<dynamic_config> a bit.
=back
=item August 23, 2005
=over 2
=item *
Removed the name C<CPAN::META::Specification>, since that implies a
module that doesn't actually exist.
=back
=item June 12, 2007
=over 2
=item *
Added C<configure_requires>.
=back
=back
t/data-fail/META-1_0.yml 0000644 00000000602 15170246504 0010461 0 ustar 00 # http://module-build.sourceforge.net/META-spec.html
#XXXXXXX This is a prototype!!! It will change in the future!!! XXXXX#
name: Template-DBI
version_from: lib/Template/Plugin/DBI.pm
installdirs: site
license: perl
requires:
DBI: 1
Template: 2.15
distribution_type: module
generated_by: ExtUtils::MakeMaker version 6.17
t/data-fail/META-1_1.yml 0000644 00000000733 15170246504 0010467 0 ustar 00 --- #YAML:1.0
name: Class-Virtual
abstract: ~
license: unknown
generated_by: ExtUtils::MakeMaker version 6.30_03
author: ~
distribution_type: module
requires:
Carp::Assert: 0.1
Class::Data::Inheritable: 0.02
Class::ISA: 0.31
Test::More: 0.5
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.1.html
version: 1.1
t/data-fail/META-1_2.yml 0000644 00000001617 15170246504 0010472 0 ustar 00 ---
name: Test-Harness-Straps
author:
- 'Michael G Schwern <schwern@pobox.com>'
abstract: detailed analysis of test results
license: perl
resources:
license: http://dev.perl.org/licenses/
requires:
File::Spec: 0.6
provides:
Test::Harness::Assert:
file: lib/Test/Harness/Assert.pm
version: 0.02
Test::Harness::Iterator:
file: lib/Test/Harness/Iterator.pm
version: 0.02
Test::Harness::Iterator::ARRAY:
file: lib/Test/Harness/Iterator.pm
Test::Harness::Iterator::FH:
file: lib/Test/Harness/Iterator.pm
Test::Harness::Point:
file: lib/Test/Harness/Point.pm
version: 0.01
Test::Harness::Results:
file: lib/Test/Harness/Results.pm
version: 0.01
Test::Harness::Straps:
file: lib/Test/Harness/Straps.pm
version: 0.30
generated_by: Module::Build version 0.280801
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.2.html
version: 1.2
t/data-fail/META-1_3.yml 0000644 00000001165 15170246504 0010471 0 ustar 00 ---
abstract: a modern perl interactive shell
author:
- Matt S Trout - mst (at) shadowcatsystems.co.uk (L<http://www.shadowcatsystems.co.uk/>)
build_requires:
Test::More: 0
distribution_type: module
generated_by: Module::Install version 0.67
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.3.html
version: 1.3
name: Devel-REPL
no_index:
directory:
- inc
- t
requires:
Data::Dump::Streamer: 0
File::HomeDir: 0
File::Spec: 0
Lexical::Persistence: 0
Moose: 0
MooseX::Getopt: 0
MooseX::Object::Pluggable: 0
Term::ReadLine: 0
namespace::clean: 0
perl: 5.8.1
t/data-fail/META-1_4.yml 0000644 00000007045 15170246504 0010475 0 ustar 00 ---
abstract: 'Build and install Perl modules'
author:
- 'Ken Williams <kwilliams@cpan.org>'
- "Development questions, bug reports, and patches should be sent to the\nModule-Build mailing list at <module-build@perl.org>."
build_requires:
File::Temp: 0.15
Test::Harness: 3.16
Test::More: 0.49
generated_by: 'Module::Build version 0.3608'
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: 1.4
name: Module-Build
provides:
Module::Build:
file: lib/Module/Build.pm
version: 0.36_08
Module::Build::Base:
file: lib/Module/Build/Base.pm
version: 0.36_08
Module::Build::Compat:
file: lib/Module/Build/Compat.pm
version: 0.36_08
Module::Build::Config:
file: lib/Module/Build/Config.pm
version: 0.36_08
Module::Build::Cookbook:
file: lib/Module/Build/Cookbook.pm
version: 0.36_08
Module::Build::Dumper:
file: lib/Module/Build/Dumper.pm
version: 0.36_08
Module::Build::ModuleInfo:
file: lib/Module/Build/ModuleInfo.pm
version: 0.36_08
Module::Build::Notes:
file: lib/Module/Build/Notes.pm
version: 0.36_08
Module::Build::PPMMaker:
file: lib/Module/Build/PPMMaker.pm
version: 0.36_08
Module::Build::Platform::Amiga:
file: lib/Module/Build/Platform/Amiga.pm
version: 0.36_08
Module::Build::Platform::Default:
file: lib/Module/Build/Platform/Default.pm
version: 0.36_08
Module::Build::Platform::EBCDIC:
file: lib/Module/Build/Platform/EBCDIC.pm
version: 0.36_08
Module::Build::Platform::MPEiX:
file: lib/Module/Build/Platform/MPEiX.pm
version: 0.36_08
Module::Build::Platform::MacOS:
file: lib/Module/Build/Platform/MacOS.pm
version: 0.36_08
Module::Build::Platform::RiscOS:
file: lib/Module/Build/Platform/RiscOS.pm
version: 0.36_08
Module::Build::Platform::Unix:
file: lib/Module/Build/Platform/Unix.pm
version: 0.36_08
Module::Build::Platform::VMS:
file: lib/Module/Build/Platform/VMS.pm
version: 0.36_08
Module::Build::Platform::VOS:
file: lib/Module/Build/Platform/VOS.pm
version: 0.36_08
Module::Build::Platform::Windows:
file: lib/Module/Build/Platform/Windows.pm
version: 0.36_08
Module::Build::Platform::aix:
file: lib/Module/Build/Platform/aix.pm
version: 0.36_08
Module::Build::Platform::cygwin:
file: lib/Module/Build/Platform/cygwin.pm
version: 0.36_08
Module::Build::Platform::darwin:
file: lib/Module/Build/Platform/darwin.pm
version: 0.36_08
Module::Build::Platform::os2:
file: lib/Module/Build/Platform/os2.pm
version: 0.36_08
Module::Build::PodParser:
file: lib/Module/Build/PodParser.pm
version: 0.36_08
Module::Build::Version:
file: lib/Module/Build/Version.pm
version: 0.77
Module::Build::YAML:
file: lib/Module/Build/YAML.pm
version: 1.40
inc::latest:
file: lib/inc/latest.pm
version: 0.36_08
inc::latest::private:
file: lib/inc/latest/private.pm
version: 0.36_08
recommends:
ExtUtils::Install: 0.3
ExtUtils::Manifest: 1.54
version: 0.74
requires:
Cwd: 0
Data::Dumper: 0
ExtUtils::CBuilder: 0.27
ExtUtils::Install: 0
ExtUtils::Manifest: 0
ExtUtils::Mkbootstrap: 0
ExtUtils::ParseXS: 2.21
File::Basename: 0
File::Compare: 0
File::Copy: 0
File::Find: 0
File::Path: 0
File::Spec: 0.82
Getopt::Long: 0
IO::File: 0
Test::Harness: 0
Text::Abbrev: 0
Text::ParseWords: 0
perl: 5.006001
resources:
MailingList: mailto:module-build@perl.org
license: http://dev.perl.org/licenses/
repository: http://github.com/dagolden/module-build/
t/data-fail/META-2.json 0000644 00000003702 15170246504 0010417 0 ustar 00 {
"resources" : {
"license" : [
"http://dev.perl.org/licenses/"
]
},
"generated_by" : "Module::Build version 0.36",
"meta-spec" : {
"version" : "2",
"url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec"
},
"name" : "Module-Build",
"dynamic_config" : 1,
"author" : [
"Ken Williams <kwilliams@cpan.org>",
"Module-Build List <module-build@perl.org>"
],
"release_status" : "stable",
"license" : [
"perl_5"
],
"description" : "Module::Build is a system for building, testing, and installing Perl modules. It is meant to be an alternative to ExtUtils::MakeMaker... blah blah blah",
"keywords" : [
"toolchain",
"cpan",
"dual-life"
],
"prereqs" : {
"runtime" : {
"requires" : {
"File::Copy" : "0",
"IO::File" : "0",
"Data::Dumper" : "0",
"File::Spec" : "0",
"Config" : "0",
"ExtUtils::Install" : "0",
"perl" : "5.006",
"File::Compare" : "0",
"File::Find" : "0",
"File::Path" : "0",
"File::Basename" : "0",
"Cwd" : "0"
},
"recommends" : {
"YAML" : "0.35",
"ExtUtils::ParseXS" : "2.02",
"Pod::Text" : "0",
"ExtUtils::Install" : "0.3",
"Archive::Tar" : "1.00"
}
},
"build" : {
"requires" : {
"Test::More" : "0"
}
}
},
"optional_features" : {
"domination" : {
"prereqs" : {
"develop" : {
"requires" : {
"Genius::Evil" : "1.234"
}
},
"runtime" : {
"requires" : {
"Machine::Weather" : "2.0"
}
}
},
"description" : "Take over the world"
}
},
"abstract" : "Build and install Perl modules"
}
t/data-fixable/107650337-META.yml 0000644 00000001121 15170246504 0011575 0 ustar 00 ---
name: FabForce-DBDesigner4-DBIC
version: 0.0802
author:
- 'Renee Baecker <module@renee-baecker.de>'
abstract: create DBIC scheme for DBDesigner4 xml file
license: artistic2
requires:
FabForce::DBDesigner4: 0.3
File::Spec: 3.12
build_requires:
Carp: 0
Test::CheckManifest: 1
Test::More: 0
generated_by: Module::Build version 0.2808
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.2.html
version: 1.2
provides:
FabForce::DBDesigner4::DBIC:
file: lib/FabForce/DBDesigner4/DBIC.pm
version: 0.0802
resources:
license: http://dev.perl.org/licenses/
t/data-fixable/1598804075-META.yml 0000644 00000001200 15170246504 0011672 0 ustar 00 # http://module-build.sourceforge.net/META-spec.html
#XXXXXXX This is a prototype!!! It will change in the future!!! XXXXX#
name: XML-RDB
version: 1.3
version_from: RDB.pm
installdirs: site
requires:
Data::Dumper: 0
DBI: 1.35
DBIx::DBSchema: .16
DBIx::Recordset: .23
DBIx::Sequence: .04
Getopt::Std: 0
IO::File: 1.08
URI::Escape: 3.16
XML::DOM: 1.29
distribution_type: module
generated_by: ExtUtils::MakeMaker version 6.30
t/data-fixable/1927486199-META.yml 0000644 00000000716 15170246504 0011716 0 ustar 00 # http://module-build.sourceforge.net/META-spec.html
#XXXXXXX This is a prototype!!! It will change in the future!!! XXXXX#
name: WWW-phpBB-Mod-Installer
version: 0.03
version_from: lib/WWW/phpBB/Mod/Installer.pm
installdirs: site
requires:
DBD::mysql: 3.0002
DBI: 1.5
XML::Xerces: -4
distribution_type: module
generated_by: ExtUtils::MakeMaker version 6.30
t/data-fixable/1985980974-META.yml 0000644 00000001021 15170246504 0011710 0 ustar 00 ---
abstract: 'A Form::Sensible::Form::Reflector subclass to reflect off of DBIC schema classes'
author:
- 'Devin Austin <dhoss@cpan.org>'
generated_by: 'Dist::Zilla version 1.100160'
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: 1.4
name: Form-Sensible-Reflector-DBIC
requires:
DBIx::Class: "\"\""
Data::Dumper: "\"\""
DateTime: "\"\""
ExtUtils::MakeMaker: 6.11
Form::Sensible: "\"\""
Moose: 0.93
SQL::Translator: 0.11002
Test::Simple: 0.88
version: 0.0341
t/data-fixable/2031017050-META.yml 0000644 00000001235 15170246504 0011646 0 ustar 00 --- #YAML:1.0
name: Forks-Super
version: 0.16
abstract: extensions and convenience methods for managing background processes.
author:
- Marty O'Brien <mob@cpan.org>
license: perl
distribution_type: module
configure_requires:
ExtUtils::MakeMaker: 0
build_requires:
ExtUtils::MakeMaker: 0
requires:
Test::More: 0
no_index:
directory:
- t
- inc
generated_by: ExtUtils::MakeMaker version 6.55_02
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: 1.4
recommends:
- Time::HiRes
- 0
- YAML
- 0
- Win32::Process
- 0
t/data-fixable/284247103-META.yml 0000644 00000002454 15170246504 0011606 0 ustar 00 --- #YAML:1.0
meta-spec:
version: 1.2
url: http://module-build.sourceforge.net/META-spec-v1.2.html
name: Daizu
version: 0.3
abstract: Web publishing system built on Subversion
license: gpl
resources:
homepage: http://www.daizucms.org/
license: http://www.gnu.org/licenses/gpl.html
author:
- 'Geoff Richards <geoff@laxan.com>'
requires:
Carp::Assert: 0
Compress::Zlib: 0
DBD::Pg: 0
DateTime: 0
DateTime::Format::Pg: 0.08
Digest::SHA1: 0
File::MMagic: 0
HTML::Entities: 1.32
HTML::Parser: 0
HTML::Tagset: 0
Image::Size: 0
Math::Round: 0.03
Path::Class: 0.02
SVN::Ra: 0
Template: 2.15
URI: 0
XML::LibXML: 1.59
build_requires:
Module::Build: 0
optional_features:
- syntax-highlight:
description: Automatically syntax-highlight example code in articles
requires:
Text::VimColor: 0.09
- picture-article:
description: Publish pictures as articles, with automatic thumbnails
requires:
Image::Magick: 0
- related-links:
description: Add a Related Links box to pages for articles
requires:
Template::Plugin::Class: 0
no_index:
file:
- test-repos.dump
dynamic_config: 0
generated_by: Geoff Richards
# vi:ts=4 sw=4 expandtab
t/data-fixable/344981821-META.yml 0000644 00000001014 15170246504 0011606 0 ustar 00 ---
abstract: ''
author:
- 'Tokuhiro Matsuno C<< <tokuhiro __at__ mobilefactory.jp> >>'
build_requires:
Class::DBI: 0
Class::DBI::Pager: 0
Sledge::TestPages: 0
Test::Base: 0
Test::More: 0
YAML: 0
distribution_type: module
generated_by: 'Module::Install version 0.75'
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.3.html
version: 1.3
name: Sledge-Plugin-Pager
no_index:
directory:
- inc
- t
requires:
Lingua::EN::Inflect: 0
String::CamelCase: 0
version: 0.02
t/data-fixable/35478989-META.yml 0000644 00000001025 15170246504 0011545 0 ustar 00 --- #YAML:1.0
name: oEdtk
version: 0.42
abstract: ~
license: ~
author: ~
generated_by: ExtUtils::MakeMaker version 6.44
distribution_type: module
requires:
Config::IniFiles: 2.3
DBI: 1.6
Spreadsheet::WriteExcel: 1
Sys::Hostname: Digest::MD5
Term::ReadKey: POSIX
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.3.html
version: 1.3
t/data-fixable/98042513-META.yml 0000644 00000001047 15170246504 0011524 0 ustar 00 # http://module-build.sourceforge.net/META-spec.html
#XXXXXXX This is a prototype!!! It will change in the future!!! XXXXX#
name: Apache-ErrorControl
version: 1.026
version_from: ErrorControl.pm
installdirs: site
requires:
Apache::Constants: 1.09
Apache::File: 1.01
Apache::Request: 1.1
Class::Date:
HTML::Template::Set: 1.01
MIME::Entity: 5.404
distribution_type: module
generated_by: ExtUtils::MakeMaker version 6.17
t/data-fixable/META-1_2.yml 0000644 00000001561 15170246504 0011167 0 ustar 00 ---
name: Test-Harness-Straps
version: 0.30
author:
- 'Michael G Schwern <schwern@pobox.com>'
license: perl
resources:
license: http://dev.perl.org/licenses/
requires:
File::Spec: 0.6
provides:
Test::Harness::Assert:
file: lib/Test/Harness/Assert.pm
version: 0.02
Test::Harness::Iterator:
file: lib/Test/Harness/Iterator.pm
version: 0.02
Test::Harness::Iterator::ARRAY:
file: lib/Test/Harness/Iterator.pm
Test::Harness::Iterator::FH:
file: lib/Test/Harness/Iterator.pm
Test::Harness::Point:
file: lib/Test/Harness/Point.pm
version: 0.01
Test::Harness::Results:
file: lib/Test/Harness/Results.pm
version: 0.01
Test::Harness::Straps:
file: lib/Test/Harness/Straps.pm
version: 0.30
generated_by: Module::Build version 0.280801
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.2.html
version: 1.2
t/data-fixable/META-1_3.yml 0000644 00000001202 15170246504 0011160 0 ustar 00 ---
abstract: a modern perl interactive shell
author: Matt S Trout - mst (at) shadowcatsystems.co.uk (L<http://www.shadowcatsystems.co.uk/>)
build_requires:
Test::More: 0
distribution_type: module
generated_by: Module::Install version 0.67
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.3.html
version: 1.3
name: Devel-REPL
no_index:
directory:
- inc
- t
requires:
Data::Dump::Streamer: 0
File::HomeDir: 0
File::Spec: 0
Lexical::Persistence: 0
Moose: 0
MooseX::Getopt: 0
MooseX::Object::Pluggable: 0
Term::ReadLine: 0
namespace::clean: 0
perl: 5.8.1
version: 1.001000
t/data-fixable/META-1_4.yml 0000644 00000007012 15170246504 0011166 0 ustar 00 ---
author:
- 'Ken Williams <kwilliams@cpan.org>'
- "Development questions, bug reports, and patches should be sent to the\nModule-Build mailing list at <module-build@perl.org>."
build_requires:
File::Temp: 0.15
Test::Harness: 3.16
Test::More: 0.49
generated_by: 'Module::Build version 0.3608'
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: 1.4
name: Module-Build
provides:
Module::Build:
file: lib/Module/Build.pm
version: 0.36_08
Module::Build::Base:
file: lib/Module/Build/Base.pm
version: 0.36_08
Module::Build::Compat:
file: lib/Module/Build/Compat.pm
version: 0.36_08
Module::Build::Config:
file: lib/Module/Build/Config.pm
version: 0.36_08
Module::Build::Cookbook:
file: lib/Module/Build/Cookbook.pm
version: 0.36_08
Module::Build::Dumper:
file: lib/Module/Build/Dumper.pm
version: 0.36_08
Module::Build::ModuleInfo:
file: lib/Module/Build/ModuleInfo.pm
version: 0.36_08
Module::Build::Notes:
file: lib/Module/Build/Notes.pm
version: 0.36_08
Module::Build::PPMMaker:
file: lib/Module/Build/PPMMaker.pm
version: 0.36_08
Module::Build::Platform::Amiga:
file: lib/Module/Build/Platform/Amiga.pm
version: 0.36_08
Module::Build::Platform::Default:
file: lib/Module/Build/Platform/Default.pm
version: 0.36_08
Module::Build::Platform::EBCDIC:
file: lib/Module/Build/Platform/EBCDIC.pm
version: 0.36_08
Module::Build::Platform::MPEiX:
file: lib/Module/Build/Platform/MPEiX.pm
version: 0.36_08
Module::Build::Platform::MacOS:
file: lib/Module/Build/Platform/MacOS.pm
version: 0.36_08
Module::Build::Platform::RiscOS:
file: lib/Module/Build/Platform/RiscOS.pm
version: 0.36_08
Module::Build::Platform::Unix:
file: lib/Module/Build/Platform/Unix.pm
version: 0.36_08
Module::Build::Platform::VMS:
file: lib/Module/Build/Platform/VMS.pm
version: 0.36_08
Module::Build::Platform::VOS:
file: lib/Module/Build/Platform/VOS.pm
version: 0.36_08
Module::Build::Platform::Windows:
file: lib/Module/Build/Platform/Windows.pm
version: 0.36_08
Module::Build::Platform::aix:
file: lib/Module/Build/Platform/aix.pm
version: 0.36_08
Module::Build::Platform::cygwin:
file: lib/Module/Build/Platform/cygwin.pm
version: 0.36_08
Module::Build::Platform::darwin:
file: lib/Module/Build/Platform/darwin.pm
version: 0.36_08
Module::Build::Platform::os2:
file: lib/Module/Build/Platform/os2.pm
version: 0.36_08
Module::Build::PodParser:
file: lib/Module/Build/PodParser.pm
version: 0.36_08
Module::Build::Version:
file: lib/Module/Build/Version.pm
version: 0.77
Module::Build::YAML:
file: lib/Module/Build/YAML.pm
version: 1.40
inc::latest:
file: lib/inc/latest.pm
version: 0.36_08
inc::latest::private:
file: lib/inc/latest/private.pm
version: 0.36_08
recommends:
ExtUtils::Install: 0.3
ExtUtils::Manifest: 1.54
version: 0.74
requires:
Cwd: 0
Data::Dumper: 0
ExtUtils::CBuilder: 0.27
ExtUtils::Install: 0
ExtUtils::Manifest: 0
ExtUtils::Mkbootstrap: 0
ExtUtils::ParseXS: 2.21
File::Basename: 0
File::Compare: 0
File::Copy: 0
File::Find: 0
File::Path: 0
File::Spec: 0.82
Getopt::Long: 0
IO::File: 0
Test::Harness: 0
Text::Abbrev: 0
Text::ParseWords: 0
perl: 5.006001
resources:
MailingList: mailto:module-build@perl.org
license: http://dev.perl.org/licenses/
repository: http://github.com/dagolden/module-build/
version: 0.36_08
t/data-fixable/META-2.json 0000644 00000003700 15170246504 0011114 0 ustar 00 {
"resources" : {
"license" : [
"http://dev.perl.org/licenses/"
]
},
"generated_by" : "Module::Build version 0.36",
"meta-spec" : {
"version" : "2",
"url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec"
},
"version" : "0.36",
"name" : "Module-Build",
"author" : [
"Ken Williams <kwilliams@cpan.org>",
"Module-Build List <module-build@perl.org>"
],
"release_status" : "stable",
"license" : [
"perl_5"
],
"description" : "Module::Build is a system for building, testing, and installing Perl modules. It is meant to be an alternative to ExtUtils::MakeMaker... blah blah blah",
"keywords" : [
"toolchain",
"cpan",
"dual-life"
],
"prereqs" : {
"runtime" : {
"requires" : {
"File::Copy" : "0",
"IO::File" : "0",
"Data::Dumper" : "0",
"File::Spec" : "0",
"Config" : "0",
"ExtUtils::Install" : "0",
"perl" : "5.006",
"File::Compare" : "0",
"File::Find" : "0",
"File::Path" : "0",
"File::Basename" : "0",
"Cwd" : "0"
},
"recommends" : {
"YAML" : "0.35",
"ExtUtils::ParseXS" : "2.02",
"Pod::Text" : "0",
"ExtUtils::Install" : "0.3",
"Archive::Tar" : "1.00"
}
},
"build" : {
"requires" : {
"Test::More" : "0"
}
}
},
"optional_features" : {
"domination" : {
"prereqs" : {
"develop" : {
"requires" : {
"Genius::Evil" : "1.234"
}
},
"runtime" : {
"requires" : {
"Machine::Weather" : "2.0"
}
}
},
"description" : "Take over the world"
}
},
"abstract" : "Build and install Perl modules"
}
t/data-fixable/invalid-meta-spec-version.json 0000644 00000004453 15170246504 0015222 0 ustar 00 {
"resources" : {
"license" : [
"http://dev.perl.org/licenses/"
],
"repository" : {
"url" : "svn://repo.example.com/foo-bar#fakeanchor",
"web" : "http://www.example.com"
}
},
"generated_by" : "Module::Build version 0.36",
"meta-spec" : {
"version" : "99",
"url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec"
},
"version" : "0.36",
"name" : "Module-Build",
"dynamic_config" : 1,
"author" : [
"Ken Williams <kwilliams@cpan.org>",
"Module-Build List <module-build@perl.org>"
],
"release_status" : "stable",
"license" : [
"perl_5"
],
"description" : "Module::Build is a system for building, testing, and installing Perl modules. It is meant to be an alternative to ExtUtils::MakeMaker... blah blah blah",
"keywords" : [
"toolchain",
"cpan",
"dual-life"
],
"prereqs" : {
"runtime" : {
"requires" : {
"File::Copy" : "0",
"IO::File" : "0",
"Data::Dumper" : "0",
"File::Spec" : "0",
"Config" : "0",
"ExtUtils::Install" : "0",
"perl" : "5.006",
"File::Compare" : "0",
"File::Find" : "0",
"File::Path" : "0",
"File::Basename" : "0",
"Cwd" : "0"
},
"recommends" : {
"YAML" : "0.35",
"ExtUtils::ParseXS" : "2.02",
"Pod::Text" : "0",
"ExtUtils::Install" : "0.3",
"Archive::Tar" : "1.00"
}
},
"build" : {
"requires" : {
"Build::Requires": "1.1",
"Test::More" : "0"
}
},
"test" : {
"requires" : {
"Test::More" : "0.88",
"Test::Requires" : "1.2"
}
}
},
"optional_features" : {
"domination" : {
"prereqs" : {
"develop" : {
"requires" : {
"Genius::Evil" : "1.234"
}
},
"runtime" : {
"requires" : {
"Machine::Weather" : "2.0"
}
}
},
"description" : "Take over the world"
}
},
"abstract" : "Build and install Perl modules",
"x_whatever" : "Custom key"
}
t/data-fixable/invalid-meta-spec-version.yml 0000644 00000007200 15170246504 0015043 0 ustar 00 ---
abstract: 'Build and install Perl modules'
author:
- 'Ken Williams <kwilliams@cpan.org>'
- "Development questions, bug reports, and patches should be sent to the\nModule-Build mailing list at <module-build@perl.org>."
build_requires:
File::Temp: 0.15
Test::Harness: 3.16
Test::More: 0.49
generated_by: 'Module::Build version 0.3608'
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: X
name: Module-Build
provides:
Module::Build:
file: lib/Module/Build.pm
version: 0.36_08
Module::Build::Base:
file: lib/Module/Build/Base.pm
version: 0.36_08
Module::Build::Compat:
file: lib/Module/Build/Compat.pm
version: 0.36_08
Module::Build::Config:
file: lib/Module/Build/Config.pm
version: 0.36_08
Module::Build::Cookbook:
file: lib/Module/Build/Cookbook.pm
version: 0.36_08
Module::Build::Dumper:
file: lib/Module/Build/Dumper.pm
version: 0.36_08
Module::Build::ModuleInfo:
file: lib/Module/Build/ModuleInfo.pm
version: 0.36_08
Module::Build::Notes:
file: lib/Module/Build/Notes.pm
version: 0.36_08
Module::Build::PPMMaker:
file: lib/Module/Build/PPMMaker.pm
version: 0.36_08
Module::Build::Platform::Amiga:
file: lib/Module/Build/Platform/Amiga.pm
version: 0.36_08
Module::Build::Platform::Default:
file: lib/Module/Build/Platform/Default.pm
version: 0.36_08
Module::Build::Platform::EBCDIC:
file: lib/Module/Build/Platform/EBCDIC.pm
version: 0.36_08
Module::Build::Platform::MPEiX:
file: lib/Module/Build/Platform/MPEiX.pm
version: 0.36_08
Module::Build::Platform::MacOS:
file: lib/Module/Build/Platform/MacOS.pm
version: 0.36_08
Module::Build::Platform::RiscOS:
file: lib/Module/Build/Platform/RiscOS.pm
version: 0.36_08
Module::Build::Platform::Unix:
file: lib/Module/Build/Platform/Unix.pm
version: 0.36_08
Module::Build::Platform::VMS:
file: lib/Module/Build/Platform/VMS.pm
version: 0.36_08
Module::Build::Platform::VOS:
file: lib/Module/Build/Platform/VOS.pm
version: 0.36_08
Module::Build::Platform::Windows:
file: lib/Module/Build/Platform/Windows.pm
version: 0.36_08
Module::Build::Platform::aix:
file: lib/Module/Build/Platform/aix.pm
version: 0.36_08
Module::Build::Platform::cygwin:
file: lib/Module/Build/Platform/cygwin.pm
version: 0.36_08
Module::Build::Platform::darwin:
file: lib/Module/Build/Platform/darwin.pm
version: 0.36_08
Module::Build::Platform::os2:
file: lib/Module/Build/Platform/os2.pm
version: 0.36_08
Module::Build::PodParser:
file: lib/Module/Build/PodParser.pm
version: 0.36_08
Module::Build::Version:
file: lib/Module/Build/Version.pm
version: 0.77
Module::Build::YAML:
file: lib/Module/Build/YAML.pm
version: 1.40
inc::latest:
file: lib/inc/latest.pm
version: 0.36_08
inc::latest::private:
file: lib/inc/latest/private.pm
version: 0.36_08
recommends:
ExtUtils::Install: 0.3
ExtUtils::Manifest: 1.54
version: 0.74
requires:
Cwd: 0
Data::Dumper: 0
ExtUtils::CBuilder: 0.27
ExtUtils::Install: 0
ExtUtils::Manifest: 0
ExtUtils::Mkbootstrap: 0
ExtUtils::ParseXS: 2.21
File::Basename: 0
File::Compare: 0
File::Copy: 0
File::Find: 0
File::Path: 0
File::Spec: 0.82
Getopt::Long: 0
IO::File: 0
Test::Harness: 0
Text::Abbrev: 0
Text::ParseWords: 0
perl: 5.006001
resources:
MailingList: mailto:module-build@perl.org
license: http://dev.perl.org/licenses/
repository: http://github.com/dagolden/module-build/
version: 0.36_08
x-whatever: this is a custom field
x_whatelse: so is this
XWhatNow: and this
t/data-fixable/meta-spec-version-trailing-zeros.json 0000644 00000004454 15170246504 0016546 0 ustar 00 {
"resources" : {
"license" : [
"http://dev.perl.org/licenses/"
],
"repository" : {
"url" : "svn://repo.example.com/foo-bar#fakeanchor",
"web" : "http://www.example.com"
}
},
"generated_by" : "Module::Build version 0.36",
"meta-spec" : {
"version" : "2.0",
"url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec"
},
"version" : "0.36",
"name" : "Module-Build",
"dynamic_config" : 1,
"author" : [
"Ken Williams <kwilliams@cpan.org>",
"Module-Build List <module-build@perl.org>"
],
"release_status" : "stable",
"license" : [
"perl_5"
],
"description" : "Module::Build is a system for building, testing, and installing Perl modules. It is meant to be an alternative to ExtUtils::MakeMaker... blah blah blah",
"keywords" : [
"toolchain",
"cpan",
"dual-life"
],
"prereqs" : {
"runtime" : {
"requires" : {
"File::Copy" : "0",
"IO::File" : "0",
"Data::Dumper" : "0",
"File::Spec" : "0",
"Config" : "0",
"ExtUtils::Install" : "0",
"perl" : "5.006",
"File::Compare" : "0",
"File::Find" : "0",
"File::Path" : "0",
"File::Basename" : "0",
"Cwd" : "0"
},
"recommends" : {
"YAML" : "0.35",
"ExtUtils::ParseXS" : "2.02",
"Pod::Text" : "0",
"ExtUtils::Install" : "0.3",
"Archive::Tar" : "1.00"
}
},
"build" : {
"requires" : {
"Build::Requires": "1.1",
"Test::More" : "0"
}
},
"test" : {
"requires" : {
"Test::More" : "0.88",
"Test::Requires" : "1.2"
}
}
},
"optional_features" : {
"domination" : {
"prereqs" : {
"develop" : {
"requires" : {
"Genius::Evil" : "1.234"
}
},
"runtime" : {
"requires" : {
"Machine::Weather" : "2.0"
}
}
},
"description" : "Take over the world"
}
},
"abstract" : "Build and install Perl modules",
"x_whatever" : "Custom key"
}
t/data-fixable/meta-spec-version-trailing-zeros.yml 0000644 00000007204 15170246504 0016372 0 ustar 00 ---
abstract: 'Build and install Perl modules'
author:
- 'Ken Williams <kwilliams@cpan.org>'
- "Development questions, bug reports, and patches should be sent to the\nModule-Build mailing list at <module-build@perl.org>."
build_requires:
File::Temp: 0.15
Test::Harness: 3.16
Test::More: 0.49
generated_by: 'Module::Build version 0.3608'
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: 1.400
name: Module-Build
provides:
Module::Build:
file: lib/Module/Build.pm
version: 0.36_08
Module::Build::Base:
file: lib/Module/Build/Base.pm
version: 0.36_08
Module::Build::Compat:
file: lib/Module/Build/Compat.pm
version: 0.36_08
Module::Build::Config:
file: lib/Module/Build/Config.pm
version: 0.36_08
Module::Build::Cookbook:
file: lib/Module/Build/Cookbook.pm
version: 0.36_08
Module::Build::Dumper:
file: lib/Module/Build/Dumper.pm
version: 0.36_08
Module::Build::ModuleInfo:
file: lib/Module/Build/ModuleInfo.pm
version: 0.36_08
Module::Build::Notes:
file: lib/Module/Build/Notes.pm
version: 0.36_08
Module::Build::PPMMaker:
file: lib/Module/Build/PPMMaker.pm
version: 0.36_08
Module::Build::Platform::Amiga:
file: lib/Module/Build/Platform/Amiga.pm
version: 0.36_08
Module::Build::Platform::Default:
file: lib/Module/Build/Platform/Default.pm
version: 0.36_08
Module::Build::Platform::EBCDIC:
file: lib/Module/Build/Platform/EBCDIC.pm
version: 0.36_08
Module::Build::Platform::MPEiX:
file: lib/Module/Build/Platform/MPEiX.pm
version: 0.36_08
Module::Build::Platform::MacOS:
file: lib/Module/Build/Platform/MacOS.pm
version: 0.36_08
Module::Build::Platform::RiscOS:
file: lib/Module/Build/Platform/RiscOS.pm
version: 0.36_08
Module::Build::Platform::Unix:
file: lib/Module/Build/Platform/Unix.pm
version: 0.36_08
Module::Build::Platform::VMS:
file: lib/Module/Build/Platform/VMS.pm
version: 0.36_08
Module::Build::Platform::VOS:
file: lib/Module/Build/Platform/VOS.pm
version: 0.36_08
Module::Build::Platform::Windows:
file: lib/Module/Build/Platform/Windows.pm
version: 0.36_08
Module::Build::Platform::aix:
file: lib/Module/Build/Platform/aix.pm
version: 0.36_08
Module::Build::Platform::cygwin:
file: lib/Module/Build/Platform/cygwin.pm
version: 0.36_08
Module::Build::Platform::darwin:
file: lib/Module/Build/Platform/darwin.pm
version: 0.36_08
Module::Build::Platform::os2:
file: lib/Module/Build/Platform/os2.pm
version: 0.36_08
Module::Build::PodParser:
file: lib/Module/Build/PodParser.pm
version: 0.36_08
Module::Build::Version:
file: lib/Module/Build/Version.pm
version: 0.77
Module::Build::YAML:
file: lib/Module/Build/YAML.pm
version: 1.40
inc::latest:
file: lib/inc/latest.pm
version: 0.36_08
inc::latest::private:
file: lib/inc/latest/private.pm
version: 0.36_08
recommends:
ExtUtils::Install: 0.3
ExtUtils::Manifest: 1.54
version: 0.74
requires:
Cwd: 0
Data::Dumper: 0
ExtUtils::CBuilder: 0.27
ExtUtils::Install: 0
ExtUtils::Manifest: 0
ExtUtils::Mkbootstrap: 0
ExtUtils::ParseXS: 2.21
File::Basename: 0
File::Compare: 0
File::Copy: 0
File::Find: 0
File::Path: 0
File::Spec: 0.82
Getopt::Long: 0
IO::File: 0
Test::Harness: 0
Text::Abbrev: 0
Text::ParseWords: 0
perl: 5.006001
resources:
MailingList: mailto:module-build@perl.org
license: http://dev.perl.org/licenses/
repository: http://github.com/dagolden/module-build/
version: 0.36_08
x-whatever: this is a custom field
x_whatelse: so is this
XWhatNow: and this
t/data-fixable/restrictive-2.json 0000644 00000004457 15170246504 0012743 0 ustar 00 {
"resources" : {
"license" : [
"http://dev.perl.org/licenses/"
],
"repository" : {
"url" : "svn://repo.example.com/foo-bar#fakeanchor",
"web" : "http://www.example.com"
}
},
"generated_by" : "Module::Build version 0.36",
"meta-spec" : {
"version" : "2",
"url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec"
},
"version" : "0.36",
"name" : "Module-Build",
"dynamic_config" : 1,
"author" : [
"Ken Williams <kwilliams@cpan.org>",
"Module-Build List <module-build@perl.org>"
],
"release_status" : "stable",
"license" : [
"restrictive"
],
"description" : "Module::Build is a system for building, testing, and installing Perl modules. It is meant to be an alternative to ExtUtils::MakeMaker... blah blah blah",
"keywords" : [
"toolchain",
"cpan",
"dual-life"
],
"prereqs" : {
"runtime" : {
"requires" : {
"File::Copy" : "0",
"IO::File" : "0",
"Data::Dumper" : "0",
"File::Spec" : "0",
"Config" : "0",
"ExtUtils::Install" : "0",
"perl" : "5.006",
"File::Compare" : "0",
"File::Find" : "0",
"File::Path" : "0",
"File::Basename" : "0",
"Cwd" : "0"
},
"recommends" : {
"YAML" : "0.35",
"ExtUtils::ParseXS" : "2.02",
"Pod::Text" : "0",
"ExtUtils::Install" : "0.3",
"Archive::Tar" : "1.00"
}
},
"build" : {
"requires" : {
"Build::Requires": "1.1",
"Test::More" : "0"
}
},
"test" : {
"requires" : {
"Test::More" : "0.88",
"Test::Requires" : "1.2"
}
}
},
"optional_features" : {
"domination" : {
"prereqs" : {
"develop" : {
"requires" : {
"Genius::Evil" : "1.234"
}
},
"runtime" : {
"requires" : {
"Machine::Weather" : "2.0"
}
}
},
"description" : "Take over the world"
}
},
"abstract" : "Build and install Perl modules",
"x_whatever" : "Custom key"
}
t/data-fixable/version-ranges-2.json 0000644 00000001474 15170246504 0013336 0 ustar 00 {
"generated_by" : "Module::Build version 0.36",
"meta-spec" : {
"version" : "2",
"url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec"
},
"abstract" : "stuff",
"version" : "0.36",
"name" : "Module-Build",
"dynamic_config" : 1,
"author" : [
"Ken Williams <kwilliams@cpan.org>",
"Module-Build List <module-build@perl.org>"
],
"release_status" : "stable",
"license" : [
"perl_5"
],
"description" : "Module::Build is a system for building, testing, and installing Perl modules. It is meant to be an alternative to ExtUtils::MakeMaker... blah blah blah",
"prereqs" : {
"runtime" : {
"requires" : {
"IO::File" : "1.23beta",
"Data::Dumper" : "<= v1.2.a.3",
"File::Spec" : "== mu"
}
}
}
}
t/data-test/META-1_0.yml 0000644 00000000625 15170246504 0010532 0 ustar 00 # http://module-build.sourceforge.net/META-spec.html
#XXXXXXX This is a prototype!!! It will change in the future!!! XXXXX#
name: Template-DBI
version: 2.64
version_from: lib/Template/Plugin/DBI.pm
installdirs: site
license: perl
requires:
DBI: 1
Template: 2.15
distribution_type: module
generated_by: ExtUtils::MakeMaker version 6.17
t/data-test/META-1_1.yml 0000644 00000000765 15170246504 0010540 0 ustar 00 --- #YAML:1.0
name: Class-Virtual
version: 0.06
abstract: ~
license: unknown
generated_by: ExtUtils::MakeMaker version 6.30_03
author: ~
distribution_type: module
requires:
Carp::Assert: 0.1
Class::Data::Inheritable: 0.02
Class::ISA: 0.31
Test::More: 0.5
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.1.html
version: 1.1
t/data-test/META-1_2.yml 0000644 00000001635 15170246504 0010536 0 ustar 00 ---
name: Test-Harness-Straps
version: 0.30
author:
- 'Michael G Schwern <schwern@pobox.com>'
abstract: detailed analysis of test results
license: perl
resources:
license: http://dev.perl.org/licenses/
requires:
File::Spec: 0.6
provides:
Test::Harness::Assert:
file: lib/Test/Harness/Assert.pm
version: 0.02
Test::Harness::Iterator:
file: lib/Test/Harness/Iterator.pm
version: 0.02
Test::Harness::Iterator::ARRAY:
file: lib/Test/Harness/Iterator.pm
Test::Harness::Iterator::FH:
file: lib/Test/Harness/Iterator.pm
Test::Harness::Point:
file: lib/Test/Harness/Point.pm
version: 0.01
Test::Harness::Results:
file: lib/Test/Harness/Results.pm
version: 0.01
Test::Harness::Straps:
file: lib/Test/Harness/Straps.pm
version: 0.30
generated_by: Module::Build version 0.280801
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.2.html
version: 1.2
t/data-test/META-1_3.yml 0000644 00000001207 15170246504 0010532 0 ustar 00 ---
abstract: a modern perl interactive shell
author:
- Matt S Trout - mst (at) shadowcatsystems.co.uk (L<http://www.shadowcatsystems.co.uk/>)
build_requires:
Test::More: 0
distribution_type: module
generated_by: Module::Install version 0.67
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.3.html
version: 1.3
name: Devel-REPL
no_index:
directory:
- inc
- t
requires:
Data::Dump::Streamer: 0
File::HomeDir: 0
File::Spec: 0
Lexical::Persistence: 0
Moose: 0
MooseX::Getopt: 0
MooseX::Object::Pluggable: 0
Term::ReadLine: 0
namespace::clean: 0
perl: 5.8.1
version: 1.001000
t/data-test/META-1_4.yml 0000644 00000007202 15170246504 0010534 0 ustar 00 ---
abstract: 'Build and install Perl modules'
author:
- 'Ken Williams <kwilliams@cpan.org>'
- "Development questions, bug reports, and patches should be sent to the\nModule-Build mailing list at <module-build@perl.org>."
build_requires:
File::Temp: 0.15
Test::Harness: 3.16
Test::More: 0.49
generated_by: 'Module::Build version 0.3608'
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: 1.4
name: Module-Build
provides:
Module::Build:
file: lib/Module/Build.pm
version: 0.36_08
Module::Build::Base:
file: lib/Module/Build/Base.pm
version: 0.36_08
Module::Build::Compat:
file: lib/Module/Build/Compat.pm
version: 0.36_08
Module::Build::Config:
file: lib/Module/Build/Config.pm
version: 0.36_08
Module::Build::Cookbook:
file: lib/Module/Build/Cookbook.pm
version: 0.36_08
Module::Build::Dumper:
file: lib/Module/Build/Dumper.pm
version: 0.36_08
Module::Build::ModuleInfo:
file: lib/Module/Build/ModuleInfo.pm
version: 0.36_08
Module::Build::Notes:
file: lib/Module/Build/Notes.pm
version: 0.36_08
Module::Build::PPMMaker:
file: lib/Module/Build/PPMMaker.pm
version: 0.36_08
Module::Build::Platform::Amiga:
file: lib/Module/Build/Platform/Amiga.pm
version: 0.36_08
Module::Build::Platform::Default:
file: lib/Module/Build/Platform/Default.pm
version: 0.36_08
Module::Build::Platform::EBCDIC:
file: lib/Module/Build/Platform/EBCDIC.pm
version: 0.36_08
Module::Build::Platform::MPEiX:
file: lib/Module/Build/Platform/MPEiX.pm
version: 0.36_08
Module::Build::Platform::MacOS:
file: lib/Module/Build/Platform/MacOS.pm
version: 0.36_08
Module::Build::Platform::RiscOS:
file: lib/Module/Build/Platform/RiscOS.pm
version: 0.36_08
Module::Build::Platform::Unix:
file: lib/Module/Build/Platform/Unix.pm
version: 0.36_08
Module::Build::Platform::VMS:
file: lib/Module/Build/Platform/VMS.pm
version: 0.36_08
Module::Build::Platform::VOS:
file: lib/Module/Build/Platform/VOS.pm
version: 0.36_08
Module::Build::Platform::Windows:
file: lib/Module/Build/Platform/Windows.pm
version: 0.36_08
Module::Build::Platform::aix:
file: lib/Module/Build/Platform/aix.pm
version: 0.36_08
Module::Build::Platform::cygwin:
file: lib/Module/Build/Platform/cygwin.pm
version: 0.36_08
Module::Build::Platform::darwin:
file: lib/Module/Build/Platform/darwin.pm
version: 0.36_08
Module::Build::Platform::os2:
file: lib/Module/Build/Platform/os2.pm
version: 0.36_08
Module::Build::PodParser:
file: lib/Module/Build/PodParser.pm
version: 0.36_08
Module::Build::Version:
file: lib/Module/Build/Version.pm
version: 0.77
Module::Build::YAML:
file: lib/Module/Build/YAML.pm
version: 1.40
inc::latest:
file: lib/inc/latest.pm
version: 0.36_08
inc::latest::private:
file: lib/inc/latest/private.pm
version: 0.36_08
recommends:
ExtUtils::Install: 0.3
ExtUtils::Manifest: 1.54
version: 0.74
requires:
Cwd: 0
Data::Dumper: 0
ExtUtils::CBuilder: 0.27
ExtUtils::Install: 0
ExtUtils::Manifest: 0
ExtUtils::Mkbootstrap: 0
ExtUtils::ParseXS: 2.21
File::Basename: 0
File::Compare: 0
File::Copy: 0
File::Find: 0
File::Path: 0
File::Spec: 0.82
Getopt::Long: 0
IO::File: 0
Test::Harness: 0
Text::Abbrev: 0
Text::ParseWords: 0
perl: 5.006001
resources:
MailingList: mailto:module-build@perl.org
license: http://dev.perl.org/licenses/
repository: http://github.com/dagolden/module-build/
version: 0.36_08
x-whatever: this is a custom field
x_whatelse: so is this
XWhatNow: and this
t/data-test/META-2.json 0000644 00000004467 15170246504 0010474 0 ustar 00 {
"resources" : {
"license" : [
"http://dev.perl.org/licenses/"
],
"repository" : {
"url" : "svn://repo.example.com/foo-bar#fakeanchor",
"web" : "http://www.example.com"
}
},
"generated_by" : "Module::Build version 0.36",
"meta-spec" : {
"version" : "2",
"url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec"
},
"version" : "0.36",
"name" : "Module-Build",
"dynamic_config" : 1,
"author" : [
"Ken Williams <kwilliams@cpan.org>",
"Module-Build List <module-build@perl.org>"
],
"release_status" : "stable",
"license" : [
"perl_5",
"bsd"
],
"description" : "Module::Build is a system for building, testing, and installing Perl modules. It is meant to be an alternative to ExtUtils::MakeMaker... blah blah blah",
"keywords" : [
"toolchain",
"cpan",
"dual-life"
],
"prereqs" : {
"runtime" : {
"requires" : {
"File::Copy" : "0",
"IO::File" : "0",
"Data::Dumper" : "0",
"File::Spec" : "0",
"Config" : "0",
"ExtUtils::Install" : "0",
"perl" : "5.006",
"File::Compare" : "0",
"File::Find" : "0",
"File::Path" : "0",
"File::Basename" : "0",
"Cwd" : "0"
},
"recommends" : {
"YAML" : "0.35",
"ExtUtils::ParseXS" : "2.02",
"Pod::Text" : "0",
"ExtUtils::Install" : "0.3",
"Archive::Tar" : "1.00"
}
},
"build" : {
"requires" : {
"Build::Requires": "1.1",
"Test::More" : "0"
}
},
"test" : {
"requires" : {
"Test::More" : "0.88",
"Test::Requires" : "1.2"
}
}
},
"optional_features" : {
"domination" : {
"prereqs" : {
"develop" : {
"requires" : {
"Genius::Evil" : "1.234"
}
},
"runtime" : {
"requires" : {
"Machine::Weather" : "2.0"
}
}
},
"description" : "Take over the world"
}
},
"abstract" : "Build and install Perl modules",
"x_whatever" : "Custom key"
}
t/data-test/META-2.meta 0000644 00000004461 15170246504 0010443 0 ustar 00 {
"resources" : {
"license" : [
"http://dev.perl.org/licenses/"
],
"repository" : {
"url" : "svn://repo.example.com/foo-bar#fakeanchor",
"web" : "http://www.example.com"
}
},
"generated_by" : "Module::Build version 0.36",
"meta-spec" : {
"version" : "2",
"url" : "https://metacpan.org/pod/CPAN::Meta::Spec"
},
"version" : "0.36",
"name" : "Module-Build",
"dynamic_config" : 1,
"author" : [
"Ken Williams <kwilliams@cpan.org>",
"Module-Build List <module-build@perl.org>"
],
"release_status" : "stable",
"license" : [
"perl_5",
"bsd"
],
"description" : "Module::Build is a system for building, testing, and installing Perl modules. It is meant to be an alternative to ExtUtils::MakeMaker... blah blah blah",
"keywords" : [
"toolchain",
"cpan",
"dual-life"
],
"prereqs" : {
"runtime" : {
"requires" : {
"File::Copy" : "0",
"IO::File" : "0",
"Data::Dumper" : "0",
"File::Spec" : "0",
"Config" : "0",
"ExtUtils::Install" : "0",
"perl" : "5.006",
"File::Compare" : "0",
"File::Find" : "0",
"File::Path" : "0",
"File::Basename" : "0",
"Cwd" : "0"
},
"recommends" : {
"YAML" : "0.35",
"ExtUtils::ParseXS" : "2.02",
"Pod::Text" : "0",
"ExtUtils::Install" : "0.3",
"Archive::Tar" : "1.00"
}
},
"build" : {
"requires" : {
"Build::Requires": "1.1",
"Test::More" : "0"
}
},
"test" : {
"requires" : {
"Test::More" : "0.88",
"Test::Requires" : "1.2"
}
}
},
"optional_features" : {
"domination" : {
"prereqs" : {
"develop" : {
"requires" : {
"Genius::Evil" : "1.234"
}
},
"runtime" : {
"requires" : {
"Machine::Weather" : "2.0"
}
}
},
"description" : "Take over the world"
}
},
"abstract" : "Build and install Perl modules",
"x_whatever" : "Custom key"
}
t/data-test/gpl-1_4.yml 0000644 00000001166 15170246504 0010573 0 ustar 00 ---
abstract: 'Build and install Perl modules'
author:
- 'Ken Williams <kwilliams@cpan.org>'
- "Development questions, bug reports, and patches should be sent to the\nModule-Build mailing list at <module-build@perl.org>."
build_requires:
File::Temp: 0.15
Test::Harness: 3.16
Test::More: 0.49
generated_by: 'Module::Build version 0.3608'
license: gpl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: 1.4
name: Module-Build
resources:
MailingList: mailto:module-build@perl.org
license: http://dev.perl.org/licenses/
repository: http://github.com/dagolden/module-build/
version: 3
t/data-test/preserve-release-status.yml 0000644 00000000656 15170246504 0014225 0 ustar 00 # http://module-build.sourceforge.net/META-spec.html
#XXXXXXX This is a prototype!!! It will change in the future!!! XXXXX#
name: Template-DBI
version: 2.64
version_from: lib/Template/Plugin/DBI.pm
installdirs: site
license: perl
requires:
DBI: 1
Template: 2.15
distribution_type: module
generated_by: ExtUtils::MakeMaker version 6.17
release_status: unstable
t/data-test/provides-version-missing.json 0000644 00000005153 15170246504 0014565 0 ustar 00 {
"resources" : {
"license" : [
"http://dev.perl.org/licenses/"
],
"repository" : {
"url" : "svn://repo.example.com/foo-bar#fakeanchor",
"web" : "http://www.example.com"
}
},
"generated_by" : "Module::Build version 0.36",
"meta-spec" : {
"version" : "2",
"url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec"
},
"version" : "0.36",
"name" : "Module-Build",
"dynamic_config" : 1,
"author" : [
"Ken Williams <kwilliams@cpan.org>",
"Module-Build List <module-build@perl.org>"
],
"release_status" : "stable",
"license" : [
"perl_5"
],
"description" : "Module::Build is a system for building, testing, and installing Perl modules. It is meant to be an alternative to ExtUtils::MakeMaker... blah blah blah",
"keywords" : [
"toolchain",
"cpan",
"dual-life"
],
"provides" : {
"Foo::Bar" : {
"file" : "lib/Foo/Bar.pm",
"version" : "0.27_02"
},
"Foo::Bar::Blah" : {
"file" : "lib/Foo/Bar/Blah.pm"
},
"Foo::Bar::Baz" : {
"file" : "lib/Foo/Bar/Baz.pm",
"version" : 0.3
}
},
"prereqs" : {
"runtime" : {
"requires" : {
"File::Copy" : "0",
"IO::File" : "0",
"Data::Dumper" : "0",
"File::Spec" : "0",
"Config" : "0",
"ExtUtils::Install" : "0",
"perl" : "5.006",
"File::Compare" : "0",
"File::Find" : "0",
"File::Path" : "0",
"File::Basename" : "0",
"Cwd" : "0"
},
"recommends" : {
"YAML" : "0.35",
"ExtUtils::ParseXS" : "2.02",
"Pod::Text" : "0",
"ExtUtils::Install" : "0.3",
"Archive::Tar" : "1.00"
}
},
"build" : {
"requires" : {
"Build::Requires": "1.1",
"Test::More" : "0"
}
},
"test" : {
"requires" : {
"Test::More" : "0.88",
"Test::Requires" : "1.2"
}
}
},
"optional_features" : {
"domination" : {
"prereqs" : {
"develop" : {
"requires" : {
"Genius::Evil" : "1.234"
}
},
"runtime" : {
"requires" : {
"Machine::Weather" : "2.0"
}
}
},
"description" : "Take over the world"
}
},
"abstract" : "Build and install Perl modules",
"x_whatever" : "Custom key"
}
t/data-test/resources.yml 0000644 00000002746 15170246504 0011447 0 ustar 00 --- #YAML:1.0
name: WWW-Mechanize
version: 1.64
abstract: Handy web browsing in a Perl object
author:
- Andy Lester <andy@petdance.com>
license: perl
distribution_type: module
configure_requires:
ExtUtils::MakeMaker: 0
build_requires:
ExtUtils::MakeMaker: 0
requires:
Carp: 0
File::Temp: 0
FindBin: 0
Getopt::Long: 0
HTML::Form: 1.038
HTML::HeadParser: 0
HTML::Parser: 3.33
HTML::TokeParser: 2.28
HTTP::Daemon: 0
HTTP::Request: 1.3
HTTP::Server::Simple: 0.35
HTTP::Server::Simple::CGI: 0
HTTP::Status: 0
LWP: 5.829
LWP::UserAgent: 5.829
perl: 5.008
Pod::Usage: 0
Test::More: 0.34
Test::Warn: 0.11
URI: 1.36
URI::file: 0
URI::URL: 0
resources:
bugtracker: http://code.google.com/p/www-mechanize/issues/list
homepage: http://code.google.com/p/www-mechanize/
license: http://dev.perl.org/licenses/
MailingList: http://groups.google.com/group/www-mechanize-users
Repository: http://code.google.com/p/www-mechanize/source
no_index:
directory:
- t
- inc
generated_by: ExtUtils::MakeMaker version 6.56
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: 1.4
t/data-test/restricted-2.json 0000644 00000004456 15170246504 0012114 0 ustar 00 {
"resources" : {
"license" : [
"http://dev.perl.org/licenses/"
],
"repository" : {
"url" : "svn://repo.example.com/foo-bar#fakeanchor",
"web" : "http://www.example.com"
}
},
"generated_by" : "Module::Build version 0.36",
"meta-spec" : {
"version" : "2",
"url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec"
},
"version" : "0.36",
"name" : "Module-Build",
"dynamic_config" : 1,
"author" : [
"Ken Williams <kwilliams@cpan.org>",
"Module-Build List <module-build@perl.org>"
],
"release_status" : "stable",
"license" : [
"restricted"
],
"description" : "Module::Build is a system for building, testing, and installing Perl modules. It is meant to be an alternative to ExtUtils::MakeMaker... blah blah blah",
"keywords" : [
"toolchain",
"cpan",
"dual-life"
],
"prereqs" : {
"runtime" : {
"requires" : {
"File::Copy" : "0",
"IO::File" : "0",
"Data::Dumper" : "0",
"File::Spec" : "0",
"Config" : "0",
"ExtUtils::Install" : "0",
"perl" : "5.006",
"File::Compare" : "0",
"File::Find" : "0",
"File::Path" : "0",
"File::Basename" : "0",
"Cwd" : "0"
},
"recommends" : {
"YAML" : "0.35",
"ExtUtils::ParseXS" : "2.02",
"Pod::Text" : "0",
"ExtUtils::Install" : "0.3",
"Archive::Tar" : "1.00"
}
},
"build" : {
"requires" : {
"Build::Requires": "1.1",
"Test::More" : "0"
}
},
"test" : {
"requires" : {
"Test::More" : "0.88",
"Test::Requires" : "1.2"
}
}
},
"optional_features" : {
"domination" : {
"prereqs" : {
"develop" : {
"requires" : {
"Genius::Evil" : "1.234"
}
},
"runtime" : {
"requires" : {
"Machine::Weather" : "2.0"
}
}
},
"description" : "Take over the world"
}
},
"abstract" : "Build and install Perl modules",
"x_whatever" : "Custom key"
}
t/data-test/restrictive-1_4.yml 0000644 00000007211 15170246504 0012351 0 ustar 00 ---
abstract: 'Build and install Perl modules'
author:
- 'Ken Williams <kwilliams@cpan.org>'
- "Development questions, bug reports, and patches should be sent to the\nModule-Build mailing list at <module-build@perl.org>."
build_requires:
File::Temp: 0.15
Test::Harness: 3.16
Test::More: 0.49
generated_by: 'Module::Build version 0.3608'
license: restrictive
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: 1.4
name: Module-Build
provides:
Module::Build:
file: lib/Module/Build.pm
version: 0.36_08
Module::Build::Base:
file: lib/Module/Build/Base.pm
version: 0.36_08
Module::Build::Compat:
file: lib/Module/Build/Compat.pm
version: 0.36_08
Module::Build::Config:
file: lib/Module/Build/Config.pm
version: 0.36_08
Module::Build::Cookbook:
file: lib/Module/Build/Cookbook.pm
version: 0.36_08
Module::Build::Dumper:
file: lib/Module/Build/Dumper.pm
version: 0.36_08
Module::Build::ModuleInfo:
file: lib/Module/Build/ModuleInfo.pm
version: 0.36_08
Module::Build::Notes:
file: lib/Module/Build/Notes.pm
version: 0.36_08
Module::Build::PPMMaker:
file: lib/Module/Build/PPMMaker.pm
version: 0.36_08
Module::Build::Platform::Amiga:
file: lib/Module/Build/Platform/Amiga.pm
version: 0.36_08
Module::Build::Platform::Default:
file: lib/Module/Build/Platform/Default.pm
version: 0.36_08
Module::Build::Platform::EBCDIC:
file: lib/Module/Build/Platform/EBCDIC.pm
version: 0.36_08
Module::Build::Platform::MPEiX:
file: lib/Module/Build/Platform/MPEiX.pm
version: 0.36_08
Module::Build::Platform::MacOS:
file: lib/Module/Build/Platform/MacOS.pm
version: 0.36_08
Module::Build::Platform::RiscOS:
file: lib/Module/Build/Platform/RiscOS.pm
version: 0.36_08
Module::Build::Platform::Unix:
file: lib/Module/Build/Platform/Unix.pm
version: 0.36_08
Module::Build::Platform::VMS:
file: lib/Module/Build/Platform/VMS.pm
version: 0.36_08
Module::Build::Platform::VOS:
file: lib/Module/Build/Platform/VOS.pm
version: 0.36_08
Module::Build::Platform::Windows:
file: lib/Module/Build/Platform/Windows.pm
version: 0.36_08
Module::Build::Platform::aix:
file: lib/Module/Build/Platform/aix.pm
version: 0.36_08
Module::Build::Platform::cygwin:
file: lib/Module/Build/Platform/cygwin.pm
version: 0.36_08
Module::Build::Platform::darwin:
file: lib/Module/Build/Platform/darwin.pm
version: 0.36_08
Module::Build::Platform::os2:
file: lib/Module/Build/Platform/os2.pm
version: 0.36_08
Module::Build::PodParser:
file: lib/Module/Build/PodParser.pm
version: 0.36_08
Module::Build::Version:
file: lib/Module/Build/Version.pm
version: 0.77
Module::Build::YAML:
file: lib/Module/Build/YAML.pm
version: 1.40
inc::latest:
file: lib/inc/latest.pm
version: 0.36_08
inc::latest::private:
file: lib/inc/latest/private.pm
version: 0.36_08
recommends:
ExtUtils::Install: 0.3
ExtUtils::Manifest: 1.54
version: 0.74
requires:
Cwd: 0
Data::Dumper: 0
ExtUtils::CBuilder: 0.27
ExtUtils::Install: 0
ExtUtils::Manifest: 0
ExtUtils::Mkbootstrap: 0
ExtUtils::ParseXS: 2.21
File::Basename: 0
File::Compare: 0
File::Copy: 0
File::Find: 0
File::Path: 0
File::Spec: 0.82
Getopt::Long: 0
IO::File: 0
Test::Harness: 0
Text::Abbrev: 0
Text::ParseWords: 0
perl: 5.006001
resources:
MailingList: mailto:module-build@perl.org
license: http://dev.perl.org/licenses/
repository: http://github.com/dagolden/module-build/
version: 0.36_08
x-whatever: this is a custom field
x_whatelse: so is this
XWhatNow: and this
t/data-test/unicode.yml 0000644 00000007203 15170246504 0011054 0 ustar 00 ---
abstract: 'Build and install Perl modules'
author:
- 'Ken Williåms <kwilliams@cpan.org>'
- "Development questions, bug reports, and patches should be sent to the\nModule-Build mailing list at <module-build@perl.org>."
build_requires:
File::Temp: 0.15
Test::Harness: 3.16
Test::More: 0.49
generated_by: 'Module::Build version 0.3608'
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: 1.4
name: Module-Build
provides:
Module::Build:
file: lib/Module/Build.pm
version: 0.36_08
Module::Build::Base:
file: lib/Module/Build/Base.pm
version: 0.36_08
Module::Build::Compat:
file: lib/Module/Build/Compat.pm
version: 0.36_08
Module::Build::Config:
file: lib/Module/Build/Config.pm
version: 0.36_08
Module::Build::Cookbook:
file: lib/Module/Build/Cookbook.pm
version: 0.36_08
Module::Build::Dumper:
file: lib/Module/Build/Dumper.pm
version: 0.36_08
Module::Build::ModuleInfo:
file: lib/Module/Build/ModuleInfo.pm
version: 0.36_08
Module::Build::Notes:
file: lib/Module/Build/Notes.pm
version: 0.36_08
Module::Build::PPMMaker:
file: lib/Module/Build/PPMMaker.pm
version: 0.36_08
Module::Build::Platform::Amiga:
file: lib/Module/Build/Platform/Amiga.pm
version: 0.36_08
Module::Build::Platform::Default:
file: lib/Module/Build/Platform/Default.pm
version: 0.36_08
Module::Build::Platform::EBCDIC:
file: lib/Module/Build/Platform/EBCDIC.pm
version: 0.36_08
Module::Build::Platform::MPEiX:
file: lib/Module/Build/Platform/MPEiX.pm
version: 0.36_08
Module::Build::Platform::MacOS:
file: lib/Module/Build/Platform/MacOS.pm
version: 0.36_08
Module::Build::Platform::RiscOS:
file: lib/Module/Build/Platform/RiscOS.pm
version: 0.36_08
Module::Build::Platform::Unix:
file: lib/Module/Build/Platform/Unix.pm
version: 0.36_08
Module::Build::Platform::VMS:
file: lib/Module/Build/Platform/VMS.pm
version: 0.36_08
Module::Build::Platform::VOS:
file: lib/Module/Build/Platform/VOS.pm
version: 0.36_08
Module::Build::Platform::Windows:
file: lib/Module/Build/Platform/Windows.pm
version: 0.36_08
Module::Build::Platform::aix:
file: lib/Module/Build/Platform/aix.pm
version: 0.36_08
Module::Build::Platform::cygwin:
file: lib/Module/Build/Platform/cygwin.pm
version: 0.36_08
Module::Build::Platform::darwin:
file: lib/Module/Build/Platform/darwin.pm
version: 0.36_08
Module::Build::Platform::os2:
file: lib/Module/Build/Platform/os2.pm
version: 0.36_08
Module::Build::PodParser:
file: lib/Module/Build/PodParser.pm
version: 0.36_08
Module::Build::Version:
file: lib/Module/Build/Version.pm
version: 0.77
Module::Build::YAML:
file: lib/Module/Build/YAML.pm
version: 1.40
inc::latest:
file: lib/inc/latest.pm
version: 0.36_08
inc::latest::private:
file: lib/inc/latest/private.pm
version: 0.36_08
recommends:
ExtUtils::Install: 0.3
ExtUtils::Manifest: 1.54
version: 0.74
requires:
Cwd: 0
Data::Dumper: 0
ExtUtils::CBuilder: 0.27
ExtUtils::Install: 0
ExtUtils::Manifest: 0
ExtUtils::Mkbootstrap: 0
ExtUtils::ParseXS: 2.21
File::Basename: 0
File::Compare: 0
File::Copy: 0
File::Find: 0
File::Path: 0
File::Spec: 0.82
Getopt::Long: 0
IO::File: 0
Test::Harness: 0
Text::Abbrev: 0
Text::ParseWords: 0
perl: 5.006001
resources:
MailingList: mailto:module-build@perl.org
license: http://dev.perl.org/licenses/
repository: http://github.com/dagolden/module-build/
version: 0.36_08
x-whatever: this is a custom field
x_whatelse: so is this
XWhatNow: and this
t/data-test/version-not-normal.json 0000644 00000002340 15170246504 0013344 0 ustar 00 {
"generated_by" : "Module::Build version 0.36",
"meta-spec" : {
"version" : "2",
"url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec"
},
"abstract" : "stuff",
"version" : "0.36",
"name" : "Module-Build",
"dynamic_config" : 1,
"author" : [
"Ken Williams <kwilliams@cpan.org>",
"Module-Build List <module-build@perl.org>"
],
"release_status" : "stable",
"license" : [
"perl_5"
],
"description" : "Module::Build is a system for building, testing, and installing Perl modules. It is meant to be an alternative to ExtUtils::MakeMaker... blah blah blah",
"prereqs" : {
"runtime" : {
"requires" : {
"File::Copy" : "== 2.21",
"IO::File" : "> 1.12",
"Data::Dumper" : ">= 1",
"File::Spec" : "< 5",
"File::Find" : "v0.1",
"File::Path" : "1.0.0",
"Module::Metadata" : ">= v1.0.2, <= v1.0.10"
}
},
"build" : {
"requires" : {
"Build::Requires": "1.1",
"Test::More" : "0"
}
},
"test" : {
"requires" : {
"Test::More" : "0.88",
"Test::Requires" : "1.2"
}
}
}
}
t/data-test/version-ranges-1_4.yml 0000644 00000001322 15170246504 0012745 0 ustar 00 ---
abstract: stuff
author:
- 'Ken Williams <kwilliams@cpan.org>'
- 'Module-Build List <module-build@perl.org>'
description: 'Module::Build is a system for building, testing, and installing Perl modules. It is meant to be an alternative to ExtUtils::MakeMaker... blah blah blah'
dynamic_config: 1
generated_by: 'Module::Build version 0.36'
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: 1.4
name: Module-Build
build_requires:
Build::Requires: 1.1
Test::More: 0
requires:
Data::Dumper: '>= 1'
File::Copy: '== 2.21'
File::Find: '>1, != 1.19'
File::Path: 0
File::Spec: '< 5'
IO::File: '> 1.12'
Module::Metadata: '>= v1.0.2, <= v1.0.10'
version: 0.36
t/data-test/version-ranges-2.json 0000644 00000002343 15170246504 0012677 0 ustar 00 {
"generated_by" : "Module::Build version 0.36",
"meta-spec" : {
"version" : "2",
"url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec"
},
"abstract" : "stuff",
"version" : "0.36",
"name" : "Module-Build",
"dynamic_config" : 1,
"author" : [
"Ken Williams <kwilliams@cpan.org>",
"Module-Build List <module-build@perl.org>"
],
"release_status" : "stable",
"license" : [
"perl_5"
],
"description" : "Module::Build is a system for building, testing, and installing Perl modules. It is meant to be an alternative to ExtUtils::MakeMaker... blah blah blah",
"prereqs" : {
"runtime" : {
"requires" : {
"File::Copy" : "== 2.21",
"IO::File" : "> 1.12",
"Data::Dumper" : ">= 1",
"File::Spec" : "< 5",
"File::Find" : ">1, != 1.19",
"File::Path" : "0",
"Module::Metadata" : ">= v1.0.2, <= v1.0.10"
}
},
"build" : {
"requires" : {
"Build::Requires": "1.1",
"Test::More" : "0"
}
},
"test" : {
"requires" : {
"Test::More" : "0.88",
"Test::Requires" : "1.2"
}
}
}
}
t/data-test/x_deprecated-META.json 0000644 00000010224 15170246504 0012746 0 ustar 00 {
"abstract" : "Author tests making sure correct line endings are used",
"author" : [
"Florian Ragwitz <rafl@debian.org>",
"Caleb Cushing <xenoterracide@gmail.com>",
"Karen Etheridge <ether@cpan.org>"
],
"dynamic_config" : 0,
"generated_by" : "Dist::Zilla version 5.035, CPAN::Meta::Converter version 2.150002",
"keywords" : [
"plugin",
"test",
"testing",
"author",
"development",
"whitespace",
"newline",
"linefeed",
"formatting"
],
"license" : [
"perl_5"
],
"meta-spec" : {
"url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec",
"version" : 2
},
"name" : "Dist-Zilla-Plugin-Test-EOL",
"no_index" : {
"directory" : [
"t",
"xt"
]
},
"prereqs" : {
"configure" : {
"requires" : {
"Module::Build::Tiny" : "0.039",
"perl" : "5.006"
}
},
"develop" : {
"recommends" : {
"Dist::Zilla::PluginBundle::Author::ETHER" : "0.092"
},
"requires" : {
"Dist::Zilla" : "5"
}
},
"runtime" : {
"requires" : {
"Data::Section" : "0.004",
"Dist::Zilla::File::InMemory" : "0",
"Dist::Zilla::Role::FileFinderUser" : "0",
"Dist::Zilla::Role::FileGatherer" : "0",
"Dist::Zilla::Role::FileMunger" : "0",
"Dist::Zilla::Role::PrereqSource" : "0",
"Dist::Zilla::Role::TextTemplate" : "0",
"Moose" : "0",
"Moose::Util::TypeConstraints" : "0",
"Path::Tiny" : "0",
"Sub::Exporter::ForMethods" : "0",
"namespace::autoclean" : "0",
"perl" : "5.006",
"strict" : "0",
"warnings" : "0"
}
},
"build" : {
"requires" : {
"Build::Requires": "1.1",
"Test::More" : "0"
}
},
"test" : {
"recommends" : {
"CPAN::Meta" : "2.120900"
},
"requires" : {
"Test::More" : "0.88",
"Test::Requires" : "1.2"
}
}
},
"provides" : {
"Dist::Zilla::Plugin::EOLTests" : {
"file" : "lib/Dist/Zilla/Plugin/EOLTests.pm",
"version" : "0.18",
"x_deprecated" : 1
},
"Dist::Zilla::Plugin::Test::EOL" : {
"file" : "lib/Dist/Zilla/Plugin/Test/EOL.pm",
"version" : "0.18"
}
},
"release_status" : "stable",
"resources" : {
"bugtracker" : {
"mailto" : "bug-Dist-Zilla-Plugin-Test-EOL@rt.cpan.org",
"web" : "https://rt.cpan.org/Public/Dist/Display.html?Name=Dist-Zilla-Plugin-Test-EOL"
},
"homepage" : "https://github.com/karenetheridge/Dist-Zilla-Plugin-Test-EOL",
"repository" : {
"type" : "git",
"url" : "https://github.com/karenetheridge/Dist-Zilla-Plugin-Test-EOL.git",
"web" : "https://github.com/karenetheridge/Dist-Zilla-Plugin-Test-EOL"
},
"x_IRC" : "irc://irc.perl.org/#distzilla",
"x_MailingList" : "http://dzil.org/#mailing-list"
},
"version" : "0.18",
"x_Dist_Zilla" : {
"perl" : {
"version" : "5.021010"
},
"plugins" : [
{
"class" : "Dist::Zilla::Plugin::Bootstrap::lib",
"config" : {
"Dist::Zilla::Role::Bootstrap" : {
"try_built" : null
}
},
"name" : "Bootstrap::lib",
"version" : "1.001000"
},
{
"class" : "Dist::Zilla::Plugin::VerifyPhases",
"name" : "@Author::ETHER/PHASE VERIFICATION",
"version" : "0.010"
}
],
"zilla" : {
"class" : "Dist::Zilla::Dist::Builder",
"config" : {
"is_trial" : ""
},
"version" : "5.035"
}
},
"x_authority" : "cpan:FLORA",
"x_authority_from_module" : "Dist::Zilla::Plugin::Test::EOL",
"x_contributors" : [
"Olivier Mengue <dolmen@cpan.org>",
"Shlomi Fish <shlomif@shlomifish.org>"
],
"x_permissions_from_module" : "Dist::Zilla::Plugin::Test::EOL"
}
t/data-valid/1122575719-META.yml 0000644 00000001127 15170246504 0011360 0 ustar 00 ---
abstract: 'Generate Catalyst application menus'
author:
- 'David P.C. Wollmann <converter42@gmail.com>'
build_requires:
ExtUtils::MakeMaker: 6.42
Test::More: 0
configure_requires:
ExtUtils::MakeMaker: 6.42
distribution_type: module
generated_by: 'Module::Install version 0.87'
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: 1.4
name: CatalystX-Menu-Tree
no_index:
directory:
- inc
- t
inc: []
requires:
Catalyst::Runtime: 0
MRO::Compat: 0
perl: 5.8.0
resources:
license: http://dev.perl.org/licenses/
version: 0.02
t/data-valid/1206545041-META.yml 0000644 00000005704 15170246504 0011351 0 ustar 00 ---
name: PDF-Template
version: 0.29_02
author: ~
abstract: PDF::Template
license: perl
requires:
Encode: 0.01
PDF::Writer: 0.05
perl: 5.6.0
build_requires:
IO::Scalar: 0.01
Test::More: 0.47
provides:
PDF::Template:
file: lib/PDF/Template.pm
version: 0.29_02
PDF::Template::Base:
file: lib/PDF/Template/Base.pm
version: ~
PDF::Template::Constants:
file: lib/PDF/Template/Constants.pm
version: ~
PDF::Template::Container:
file: lib/PDF/Template/Container.pm
version: ~
PDF::Template::Container::Always:
file: lib/PDF/Template/Container/Always.pm
version: ~
PDF::Template::Container::Conditional:
file: lib/PDF/Template/Container/Conditional.pm
version: ~
PDF::Template::Container::Font:
file: lib/PDF/Template/Container/Font.pm
version: ~
PDF::Template::Container::Footer:
file: lib/PDF/Template/Container/Footer.pm
version: ~
PDF::Template::Container::Header:
file: lib/PDF/Template/Container/Header.pm
version: ~
PDF::Template::Container::Loop:
file: lib/PDF/Template/Container/Loop.pm
version: ~
PDF::Template::Container::Margin:
file: lib/PDF/Template/Container/Margin.pm
version: ~
PDF::Template::Container::PageDef:
file: lib/PDF/Template/Container/PageDef.pm
version: ~
PDF::Template::Container::PdfTemplate:
file: lib/PDF/Template/Container/PdfTemplate.pm
version: ~
PDF::Template::Container::Row:
file: lib/PDF/Template/Container/Row.pm
version: ~
PDF::Template::Container::Scope:
file: lib/PDF/Template/Container/Scope.pm
version: ~
PDF::Template::Container::Section:
file: lib/PDF/Template/Container/Section.pm
version: ~
PDF::Template::Context:
file: lib/PDF/Template/Context.pm
version: ~
PDF::Template::Element:
file: lib/PDF/Template/Element.pm
version: ~
PDF::Template::Element::Bookmark:
file: lib/PDF/Template/Element/Bookmark.pm
version: ~
PDF::Template::Element::Circle:
file: lib/PDF/Template/Element/Circle.pm
version: ~
PDF::Template::Element::HorizontalRule:
file: lib/PDF/Template/Element/HorizontalRule.pm
version: ~
PDF::Template::Element::Image:
file: lib/PDF/Template/Element/Image.pm
version: ~
PDF::Template::Element::Line:
file: lib/PDF/Template/Element/Line.pm
version: ~
PDF::Template::Element::PageBreak:
file: lib/PDF/Template/Element/PageBreak.pm
version: ~
PDF::Template::Element::TextBox:
file: lib/PDF/Template/Element/TextBox.pm
version: ~
PDF::Template::Element::Var:
file: lib/PDF/Template/Element/Var.pm
version: ~
PDF::Template::Element::Weblink:
file: lib/PDF/Template/Element/Weblink.pm
version: ~
PDF::Template::Factory:
file: lib/PDF/Template/Factory.pm
version: ~
PDF::Template::Iterator:
file: lib/PDF/Template/Iterator.pm
version: ~
PDF::Template::TextObject:
file: lib/PDF/Template/TextObject.pm
version: ~
generated_by: Module::Build version 0.2701
t/data-valid/1985684504-META.yml 0000644 00000001150 15170246504 0011366 0 ustar 00 --- #YAML:1.0
name: Squatting
version: 0.30
abstract: A Camping-inspired Web Microframework for Perl
license: mit
generated_by: ExtUtils::MakeMaker version 6.36
distribution_type: module
requires:
Continuity: 0.991
Data::Dump: 0
HTTP::Daemon: 0
JSON::XS: 0
Shell::Perl: 0
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.2.html
version: 1.2
author:
- John BEPPU <beppu@cpan.org>
no_index:
- eg
- t
t/data-valid/476602558-META.yml 0000644 00000001133 15170246504 0011300 0 ustar 00 ---
abstract: 'Benchmarking with statistical confidence'
author:
- '-2001 Andrew Ho.'
build_requires:
ExtUtils::MakeMaker: 6.42
Test::More: 0
configure_requires:
ExtUtils::MakeMaker: 6.42
distribution_type: module
generated_by: 'Module::Install version 0.91'
license: gpl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: 1.4
module_name: Benchmark::Timer
name: Benchmark-Timer
no_index:
delta.pl: []
directory:
- inc
- t
requires:
Time::HiRes: 0
perl: 5.005
resources:
license: http://opensource.org/licenses/gpl-license.php
version: 0.7102
t/data-valid/META-1_0.yml 0000644 00000000247 15170246504 0010652 0 ustar 00 # http://module-build.sourceforge.net/META-spec.html
#XXXXXXX This is a prototype!!! It will change in the future!!! XXXXX#
name: Template-DBI
version: 1.23
t/data-valid/META-1_1.yml 0000644 00000000250 15170246504 0010645 0 ustar 00 --- #YAML:1.0
name: Class-Virtual
version: 1.23
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.1.html
version: 1.1
t/data-valid/META-1_4.yml 0000644 00000002102 15170246504 0010646 0 ustar 00 ---
X_deep:
deep: structure
abstract: 'Build and install Perl modules'
author:
- 'Ken Williams <kwilliams@cpan.org>'
- 'Module-Build List <module-build@perl.org>'
build_requires:
Test::More: '0'
dynamic_config: 1
generated_by: 'Module::Build version 0.36, CPAN::Meta::Converter version $VERSION'
keywords:
- toolchain
- cpan
- dual-life
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: '1.4'
name: Module-Build
optional_features:
domination:
description: 'Take over the world'
requires:
Machine::Weather: '2.0'
recommends:
Archive::Tar: '1.00'
ExtUtils::Install: '0.3'
ExtUtils::ParseXS: '2.02'
Pod::Text: '0'
YAML: '0.35'
requires:
Config: '0'
Cwd: '0'
Data::Dumper: '0'
ExtUtils::Install: '0'
File::Basename: '0'
File::Compare: '0'
File::Copy: '0'
File::Find: '0'
File::Path: '0'
File::Spec: '0'
IO::File: '0'
perl: '5.006'
resources:
license: http://dev.perl.org/licenses/
version: '0.36'
x_authority: cpan:FLORA
x_serialization_backend: 'CPAN::Meta::YAML version 0.015'
t/data-valid/META-2.json 0000644 00000004146 15170246504 0010606 0 ustar 00 {
"X_deep" : {
"deep" : "structure"
},
"abstract" : "Build and install Perl modules",
"author" : [
"Ken Williams <kwilliams@cpan.org>",
"Module-Build List <module-build@perl.org>"
],
"description" : "Module::Build is a system for building, testing, and installing Perl modules. It is meant to be an alternative to ExtUtils::MakeMaker... blah blah blah",
"dynamic_config" : 1,
"generated_by" : "Module::Build version 0.36",
"keywords" : [
"toolchain",
"cpan",
"dual-life"
],
"license" : [
"perl_5"
],
"meta-spec" : {
"url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec",
"version" : "2"
},
"name" : "Module-Build",
"optional_features" : {
"domination" : {
"description" : "Take over the world",
"prereqs" : {
"develop" : {
"requires" : {
"Genius::Evil" : "1.234"
}
},
"runtime" : {
"requires" : {
"Machine::Weather" : "2.0"
}
}
}
}
},
"prereqs" : {
"build" : {
"requires" : {
"Test::More" : "0"
}
},
"runtime" : {
"recommends" : {
"Archive::Tar" : "1.00",
"ExtUtils::Install" : "0.3",
"ExtUtils::ParseXS" : "2.02",
"Pod::Text" : "0",
"YAML" : "0.35"
},
"requires" : {
"Config" : "0",
"Cwd" : "0",
"Data::Dumper" : "0",
"ExtUtils::Install" : "0",
"File::Basename" : "0",
"File::Compare" : "0",
"File::Copy" : "0",
"File::Find" : "0",
"File::Path" : "0",
"File::Spec" : "0",
"IO::File" : "0",
"perl" : "5.006"
}
}
},
"release_status" : "stable",
"resources" : {
"license" : [
"http://dev.perl.org/licenses/"
]
},
"version" : "0.36",
"x_authority" : "cpan:FLORA",
"x_serialization_backend" : "JSON::PP version 2.27300"
}
t/data-valid/scalar-meta-spec.yml 0000644 00000001123 15170246504 0012662 0 ustar 00 # http://module-build.sourceforge.net/META-spec-new.html
#XXXXXXX This is a prototype!!! It will change in the future!!! XXXXX#
meta-spec: 1.1
name: XML-Writer
version: 0.600
abstract: Easily generate well-formed, namespace-aware XML.
authored_by:
- David Megginson <david@megginson.com>
- Ed Avis <ed@membled.com>
- Joseph Walton <joe@kafsemo.org>
license: perl
distribution_type: module
installdirs: site
build_requires:
perl: 5.006_000
recommends:
perl: 5.008_001
no_index:
package:
- XML::Writer::Namespaces
dynamic_config: 0
generated_by: Hand
t/data-valid/x_deprecated-META.yml 0000644 00000004652 15170246504 0012726 0 ustar 00 ---
abstract: 'Author tests making sure correct line endings are used'
author:
- 'Florian Ragwitz <rafl@debian.org>'
- 'Caleb Cushing <xenoterracide@gmail.com>'
- 'Karen Etheridge <ether@cpan.org>'
build_requires:
Build::Requires: '1.1'
Test::More: '0.88'
Test::Requires: '1.2'
configure_requires:
Module::Build::Tiny: '0.039'
perl: '5.006'
dynamic_config: 0
generated_by: 'Dist::Zilla version 5.035, CPAN::Meta::Converter version 2.150002'
keywords:
- plugin
- test
- testing
- author
- development
- whitespace
- newline
- linefeed
- formatting
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: '1.4'
name: Dist-Zilla-Plugin-Test-EOL
no_index:
directory:
- t
- xt
provides:
Dist::Zilla::Plugin::EOLTests:
file: lib/Dist/Zilla/Plugin/EOLTests.pm
version: '0.18'
x_deprecated: 1
Dist::Zilla::Plugin::Test::EOL:
file: lib/Dist/Zilla/Plugin/Test/EOL.pm
version: '0.18'
requires:
Data::Section: '0.004'
Dist::Zilla::File::InMemory: '0'
Dist::Zilla::Role::FileFinderUser: '0'
Dist::Zilla::Role::FileGatherer: '0'
Dist::Zilla::Role::FileMunger: '0'
Dist::Zilla::Role::PrereqSource: '0'
Dist::Zilla::Role::TextTemplate: '0'
Moose: '0'
Moose::Util::TypeConstraints: '0'
Path::Tiny: '0'
Sub::Exporter::ForMethods: '0'
namespace::autoclean: '0'
perl: '5.006'
strict: '0'
warnings: '0'
resources:
IRC: irc://irc.perl.org/#distzilla
MailingList: http://dzil.org/#mailing-list
bugtracker: https://rt.cpan.org/Public/Dist/Display.html?Name=Dist-Zilla-Plugin-Test-EOL
homepage: https://github.com/karenetheridge/Dist-Zilla-Plugin-Test-EOL
repository: https://github.com/karenetheridge/Dist-Zilla-Plugin-Test-EOL.git
version: '0.18'
x_Dist_Zilla:
perl:
version: '5.021010'
plugins:
-
class: Dist::Zilla::Plugin::Bootstrap::lib
config:
Dist::Zilla::Role::Bootstrap:
try_built: ~
name: Bootstrap::lib
version: '1.001000'
-
class: Dist::Zilla::Plugin::VerifyPhases
name: '@Author::ETHER/PHASE VERIFICATION'
version: '0.010'
zilla:
class: Dist::Zilla::Dist::Builder
config:
is_trial: ''
version: '5.035'
x_authority: cpan:FLORA
x_authority_from_module: Dist::Zilla::Plugin::Test::EOL
x_contributors:
- 'Olivier Mengue <dolmen@cpan.org>'
- 'Shlomi Fish <shlomif@shlomifish.org>'
x_permissions_from_module: Dist::Zilla::Plugin::Test::EOL
t/lib/Parse/CPAN/Meta/Test.pm 0000644 00000004060 15170246504 0011517 0 ustar 00 package Parse::CPAN::Meta::Test;
use strict;
use Test::More ();
use Parse::CPAN::Meta;
use File::Spec;
use vars qw{@ISA @EXPORT};
BEGIN {
require Exporter;
@ISA = qw{ Exporter };
@EXPORT = qw{
tests yaml_ok yaml_error slurp load_ok
test_data_directory
};
}
sub test_data_directory {
return( "corpus" );
}
# 22 tests per call to yaml_ok
# 4 tests per call to load_ok
sub tests {
return ( tests => count(@_) );
}
sub count {
my $yaml_ok = shift || 0;
my $load_ok = shift || 0;
my $single = shift || 0;
my $count = $yaml_ok * 3 + $load_ok * 4 + $single;
return $count;
}
sub yaml_ok {
my $string = shift;
my $array = shift;
my $name = shift || 'unnamed';
# Does the string parse to the structure
my $yaml_copy = $string;
my @yaml = eval { Parse::CPAN::Meta::Load( $yaml_copy ); };
Test::More::is( $@, '', "$name: Parse::CPAN::Meta parses without error" );
Test::More::is( $yaml_copy, $string, "$name: Parse::CPAN::Meta does not modify the input string" );
SKIP: {
Test::More::skip( "Shortcutting after failure", 1 ) if $@;
Test::More::is_deeply( \@yaml, $array, "$name: Parse::CPAN::Meta parses correctly" );
}
# Return true as a convenience
return 1;
}
sub yaml_error {
my $string = shift;
my $yaml = eval { Parse::CPAN::Meta::Load( $string ); };
Test::More::like( $@, qr/$_[0]/, "CPAN::Meta::YAML throws expected error" );
}
sub slurp {
my $file = shift;
my $layer = shift;
$layer = "" unless defined $layer;
local $/ = undef;
open my $fh, "<$layer", $file or die "open($file) failed: $!";
my $source = <$fh>;
close( $fh ) or die "close($file) failed: $!";
$source;
}
sub load_ok {
my $name = shift;
my $file = shift;
my $size = shift;
my $layer = shift;
Test::More::ok( -f $file, "Found $name" ) or Test::More::diag("Searched at '$file'");
Test::More::ok( -r $file, "Can read $name" );
my $content = slurp( $file, $layer );
Test::More::ok( (defined $content and ! ref $content), "Loaded $name" );
Test::More::ok( ($size < length $content), "Content of $name larger than $size bytes" );
return $content;
}
1;
t/parse-cpan-meta/02_api.t 0000644 00000017337 15170246504 0011242 0 ustar 00 #!/usr/bin/perl
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_DECODER};
# Testing of a known-bad file from an editor
use strict;
BEGIN {
$| = 1;
$^W = 1;
}
use lib 't/lib';
use File::Spec::Functions ':ALL';
use Parse::CPAN::Meta;
use Parse::CPAN::Meta::Test;
# use Test::More skip_all => 'Temporarily ignoring failing test';
use Test::More 'no_plan';
use utf8;
#####################################################################
# Testing that Perl::Smith config files work
my $want = {
"abstract" => "a set of version requirements for a CPAN dist",
"author" => [ 'Ricardo Signes <rjbs@cpan.org>' ],
"build_requires" => {
"Test::More" => "0.88"
},
"configure_requires" => {
"ExtUtils::MakeMaker" => "6.31"
},
"generated_by" => "Dist::Zilla version 2.100991",
"license" => "perl",
"meta-spec" => {
"url" => "http://module-build.sourceforge.net/META-spec-v1.4.html",
"version" => 1.4
},
"name" => "Version-Requirements",
"recommends" => {},
"requires" => {
"Carp" => "0",
"Scalar::Util" => "0",
"version" => "0.77"
},
"resources" => {
"repository" => "git://git.codesimply.com/Version-Requirements.git"
},
"version" => "0.101010",
"x_contributors" => [
"Dagfinn Ilmari Mannsåker <ilmari\@ilmari.org>",
],
};
my $meta_json = catfile( test_data_directory(), 'META-VR.json' );
my $meta_yaml = catfile( test_data_directory(), 'META-VR.yml' );
my $bare_yaml_meta = catfile( test_data_directory(), 'bareyaml.meta' );
my $bad_yaml_meta = catfile( test_data_directory(), 'BadMETA.yml' );
my $CL018_yaml_meta = catfile( test_data_directory(), 'CL018_yaml.meta' );
# These test YAML/JSON detection without the typical file name suffix
my $yaml_meta = catfile( test_data_directory(), 'yaml.meta' );
my $json_meta = catfile( test_data_directory(), 'json.meta' );
### YAML tests
{
local $ENV{PERL_YAML_BACKEND} if not $ENV{PERL_CORE}; # ensure we always get CPAN::META::YAML
is(Parse::CPAN::Meta->yaml_backend(), 'CPAN::Meta::YAML', 'yaml_backend(): CPAN::Meta::YAML');
my $from_yaml = Parse::CPAN::Meta->load_file( $meta_yaml );
is_deeply($from_yaml, $want, "load from YAML file results in expected data");
}
{
local $ENV{PERL_YAML_BACKEND} if not $ENV{PERL_CORE}; # ensure we always get CPAN::META::YAML
note '';
is(Parse::CPAN::Meta->yaml_backend(), 'CPAN::Meta::YAML', 'yaml_backend(): CPAN::Meta::YAML');
my $from_yaml = Parse::CPAN::Meta->load_file( $yaml_meta );
is_deeply($from_yaml, $want, "load from YAML .meta file results in expected data");
}
{
local $ENV{PERL_YAML_BACKEND} if not $ENV{PERL_CORE}; # ensure we always get CPAN::META::YAML
note '';
is(Parse::CPAN::Meta->yaml_backend(), 'CPAN::Meta::YAML', 'yaml_backend(): CPAN::Meta::YAML');
my $from_yaml = Parse::CPAN::Meta->load_file( $bare_yaml_meta );
is_deeply($from_yaml, $want, "load from bare YAML .meta file results in expected data");
}
{
local $ENV{PERL_YAML_BACKEND} if not $ENV{PERL_CORE}; # ensure we always get CPAN::META::YAML
note '';
is(Parse::CPAN::Meta->yaml_backend(), 'CPAN::Meta::YAML', 'yaml_backend(): CPAN::Meta::YAML');
my $from_yaml = Parse::CPAN::Meta->load_file( $CL018_yaml_meta );
like($from_yaml->{x_contributors}[5], qr/Olivier Mengu/, "Open question: what to expect from double encoded UTF-8");
}
{
local $ENV{PERL_YAML_BACKEND} if not $ENV{PERL_CORE}; # ensure we always get CPAN::META::YAML
note '';
is(Parse::CPAN::Meta->yaml_backend(), 'CPAN::Meta::YAML', 'yaml_backend(): CPAN::Meta::YAML');
my $yaml = load_ok( $meta_yaml, $meta_yaml, 100, ":encoding(UTF-8)");
my $from_yaml = Parse::CPAN::Meta->load_yaml_string( $yaml );
is_deeply($from_yaml, $want, "load from YAML str results in expected data");
}
{
local $ENV{PERL_YAML_BACKEND} if not $ENV{PERL_CORE}; # ensure we always get CPAN::META::YAML
note '';
is(Parse::CPAN::Meta->yaml_backend(), 'CPAN::Meta::YAML', 'yaml_backend(): CPAN::Meta::YAML');
my @yaml = Parse::CPAN::Meta::LoadFile( $bad_yaml_meta );
is($yaml[0]{author}[0], 'Olivier Mengu\xE9', "Bad UTF-8 is replaced");
}
SKIP: {
note '';
skip 'these tests are for cpan builds only', 2 if $ENV{PERL_CORE};
skip "YAML module not installed", 2
unless eval "require YAML; 1";
local $ENV{PERL_YAML_BACKEND} = 'YAML';
is(Parse::CPAN::Meta->yaml_backend(), 'YAML', 'yaml_backend(): YAML');
my $yaml = load_ok( $meta_yaml, $meta_yaml, 100, ":encoding(UTF-8)");
my $from_yaml = Parse::CPAN::Meta->load_yaml_string( $yaml );
is_deeply($from_yaml, $want, "load_yaml_string using PERL_YAML_BACKEND");
}
### JSON tests
{
# JSON tests with JSON::PP
local $ENV{PERL_JSON_BACKEND} if not $ENV{PERL_CORE}; # ensure we always get JSON::PP
note '';
is(Parse::CPAN::Meta->json_backend(), 'JSON::PP', 'json_backend(): JSON::PP');
my $from_json = Parse::CPAN::Meta->load_file( $meta_json );
is_deeply($from_json, $want, "load from JSON file results in expected data");
}
{
# JSON tests with JSON::PP
local $ENV{PERL_JSON_BACKEND} if not $ENV{PERL_CORE}; # ensure we always get JSON::PP
note '';
is(Parse::CPAN::Meta->json_backend(), 'JSON::PP', 'json_backend(): JSON::PP');
my $from_json = Parse::CPAN::Meta->load_file( $json_meta );
is_deeply($from_json, $want, "load from JSON .meta file results in expected data");
}
{
# JSON tests with JSON::PP
local $ENV{PERL_JSON_BACKEND} if not $ENV{PERL_CORE}; # ensure we always get JSON::PP
note '';
is(Parse::CPAN::Meta->json_backend(), 'JSON::PP', 'json_backend(): JSON::PP');
my $json = load_ok( $meta_json, $meta_json, 100, "encoding(UTF-8)");
my $from_json = Parse::CPAN::Meta->load_json_string( $json );
is_deeply($from_json, $want, "load from JSON str results in expected data");
}
{
# JSON tests with JSON::PP, take 2
local $ENV{PERL_JSON_BACKEND} = 0 if not $ENV{PERL_CORE}; # request JSON::PP
note '';
is(Parse::CPAN::Meta->json_backend(), 'JSON::PP', 'json_backend(): JSON::PP');
my $json = load_ok( $meta_json, $meta_json, 100, ":encoding(UTF-8)");
my $from_json = Parse::CPAN::Meta->load_json_string( $json );
is_deeply($from_json, $want, "load_json_string with PERL_JSON_BACKEND = 0");
}
{
# JSON tests with JSON::PP, take 3
local $ENV{PERL_JSON_BACKEND} = 'JSON::PP' if not $ENV{PERL_CORE}; # request JSON::PP
note '';
is(Parse::CPAN::Meta->json_backend(), 'JSON::PP', 'json_backend(): JSON::PP');
my $json = load_ok( $meta_json, $meta_json, 100, ":encoding(UTF-8)");
my $from_json = Parse::CPAN::Meta->load_json_string( $json );
is_deeply($from_json, $want, "load_json_string with PERL_JSON_BACKEND = 'JSON::PP'");
}
SKIP: {
# JSON tests with fake backend
note '';
skip 'these tests are for cpan builds only', 2 if $ENV{PERL_CORE};
{ package MyJSONThingy; $INC{'MyJSONThingy.pm'} = __FILE__; require JSON::PP;
sub decode_json { JSON::PP::decode_json(@_) } }
local $ENV{CPAN_META_JSON_DECODER} = 'MyJSONThingy'; # request fake backend
is(Parse::CPAN::Meta->json_decoder(), 'MyJSONThingy', 'json_decoder(): MyJSONThingy');
my $json = load_ok( $meta_json, $meta_json, 100, ":encoding(UTF-8)");
my $from_json = Parse::CPAN::Meta->load_json_string( $json );
is_deeply($from_json, $want, "load_json_string with PERL_JSON_DECODER = 'MyJSONThingy'");
}
SKIP: {
note '';
skip 'these tests are for cpan builds only', 2 if $ENV{PERL_CORE};
skip "JSON module version 2.5 not installed", 2
unless eval "require JSON; JSON->VERSION(2.5); 1";
local $ENV{PERL_JSON_BACKEND} = 1;
is(Parse::CPAN::Meta->json_backend(), 'JSON', 'json_backend(): JSON');
my $json = load_ok( $meta_json, $meta_json, 100, ":encoding(UTF-8)");
my $from_json = Parse::CPAN::Meta->load_json_string( $json );
is_deeply($from_json, $want, "load_json_string with PERL_JSON_BACKEND = 1");
}
t/parse-cpan-meta/03_functions.t 0000644 00000001062 15170246504 0012466 0 ustar 00 #!/usr/bin/perl
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
# Testing of basic document structures
use strict;
BEGIN {
$| = 1;
$^W = 1;
}
use Test::More tests => 2;
use Parse::CPAN::Meta ();
my $one = <<'END_YAML';
---
- foo
END_YAML
my $two = <<'END_YAML';
---
- foo
---
- bar
END_YAML
my $one_scalar_tiny = Parse::CPAN::Meta::Load( $one );
my $two_scalar_tiny = Parse::CPAN::Meta::Load( $two );
is_deeply( $one_scalar_tiny, [ 'foo' ], 'one: Parsed correctly' );
is_deeply( $two_scalar_tiny, [ 'bar' ], 'two: Parsed correctly' );
t/parse-cpan-meta/04_export.t 0000644 00000000676 15170246504 0012012 0 ustar 00 #!/usr/bin/perl
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
# Testing of basic document structures
use strict;
BEGIN {
$| = 1;
$^W = 1;
}
use Test::More tests => 4;
use Parse::CPAN::Meta;
ok not(defined &main::Load), 'Load is not exported';
ok not(defined &main::Dump), 'Dump is not exported';
ok not(defined &main::LoadFile), 'LoadFile is not exported';
ok not(defined &main::DumpFile), 'DumpFile is not exported';
t/parse-cpan-meta/05_errors.t 0000644 00000000630 15170246504 0011774 0 ustar 00 #!/usr/bin/perl
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
# Testing of basic document structures
use strict;
BEGIN {
$| = 1;
$^W = 1;
}
use Test::More tests => 1;
use Parse::CPAN::Meta ();
my $one = <<'END_YAML';
---
- foo: - bar
END_YAML
my $one_scalar_tiny = eval { Parse::CPAN::Meta->load_yaml_string( $one ) };
like( $@, '/illegal characters/', "error causes exception");
t/00-report-prereqs.dd 0000644 00000017604 15170246504 0010543 0 ustar 00 do { my $x = {
'configure' => {
'requires' => {
'ExtUtils::MakeMaker' => '6.17',
'perl' => '5.008001'
},
'suggests' => {
'JSON::PP' => '2.27300'
}
},
'develop' => {
'recommends' => {
'Perl::Critic::Policy::Lax::ProhibitStringyEval::ExceptForRequire' => '0'
},
'requires' => {
'Dist::Zilla' => '5',
'Dist::Zilla::Plugin::Authority' => '0',
'Dist::Zilla::Plugin::AutoPrereqs' => '0',
'Dist::Zilla::Plugin::BumpVersionAfterRelease' => '0',
'Dist::Zilla::Plugin::CPANFile' => '0',
'Dist::Zilla::Plugin::CheckChangesHasContent' => '0',
'Dist::Zilla::Plugin::CheckMetaResources' => '0',
'Dist::Zilla::Plugin::CheckPrereqsIndexed' => '0',
'Dist::Zilla::Plugin::ConfirmRelease' => '0',
'Dist::Zilla::Plugin::CopyFilesFromBuild::Filtered' => '0',
'Dist::Zilla::Plugin::DualLife' => '0',
'Dist::Zilla::Plugin::Encoding' => '0',
'Dist::Zilla::Plugin::Git::Check' => '0',
'Dist::Zilla::Plugin::Git::CheckFor::CorrectBranch' => '0',
'Dist::Zilla::Plugin::Git::Commit' => '0',
'Dist::Zilla::Plugin::Git::Contributors' => '0',
'Dist::Zilla::Plugin::Git::GatherDir' => '0',
'Dist::Zilla::Plugin::Git::Push' => '0',
'Dist::Zilla::Plugin::Git::Remote::Check' => '0',
'Dist::Zilla::Plugin::Git::Tag' => '0',
'Dist::Zilla::Plugin::GithubMeta' => '0',
'Dist::Zilla::Plugin::InsertCopyright' => '0',
'Dist::Zilla::Plugin::License' => '0',
'Dist::Zilla::Plugin::MakeMaker' => '0',
'Dist::Zilla::Plugin::MakeMaker::Highlander' => '0.003',
'Dist::Zilla::Plugin::Manifest' => '0',
'Dist::Zilla::Plugin::ManifestSkip' => '0',
'Dist::Zilla::Plugin::MetaJSON' => '0',
'Dist::Zilla::Plugin::MetaNoIndex' => '0',
'Dist::Zilla::Plugin::MetaProvides::Package' => '0',
'Dist::Zilla::Plugin::MetaTests' => '0',
'Dist::Zilla::Plugin::MetaYAML' => '0',
'Dist::Zilla::Plugin::MinimumPerl' => '0',
'Dist::Zilla::Plugin::NextRelease' => '0',
'Dist::Zilla::Plugin::OnlyCorePrereqs' => '0.014',
'Dist::Zilla::Plugin::Pod2Readme' => '0',
'Dist::Zilla::Plugin::PodCoverageTests' => '0',
'Dist::Zilla::Plugin::PodSyntaxTests' => '0',
'Dist::Zilla::Plugin::Prereqs' => '0',
'Dist::Zilla::Plugin::Prereqs::AuthorDeps' => '0',
'Dist::Zilla::Plugin::PromptIfStale' => '0',
'Dist::Zilla::Plugin::PruneCruft' => '0',
'Dist::Zilla::Plugin::RewriteVersion' => '0',
'Dist::Zilla::Plugin::RunExtraTests' => '0',
'Dist::Zilla::Plugin::SurgicalPodWeaver' => '0.0021',
'Dist::Zilla::Plugin::Test::Compile' => '0',
'Dist::Zilla::Plugin::Test::Perl::Critic' => '0',
'Dist::Zilla::Plugin::Test::PodSpelling' => '0',
'Dist::Zilla::Plugin::Test::Portability' => '0',
'Dist::Zilla::Plugin::Test::ReportPrereqs' => '0',
'Dist::Zilla::Plugin::Test::Version' => '0',
'Dist::Zilla::Plugin::TestRelease' => '0',
'Dist::Zilla::Plugin::UploadToCPAN' => '0',
'English' => '0',
'File::Spec' => '0',
'File::Temp' => '0',
'IO::Handle' => '0',
'IPC::Open3' => '0',
'Pod::Coverage::TrustPod' => '0',
'Pod::Weaver::PluginBundle::DAGOLDEN' => '0',
'Pod::Wordlist' => '0',
'Software::License::Perl_5' => '0',
'Test::CPAN::Meta' => '0',
'Test::More' => '0',
'Test::Pod' => '1.41',
'Test::Pod::Coverage' => '1.08',
'Test::Portability::Files' => '0',
'Test::Spelling' => '0.12',
'Test::Version' => '1',
'blib' => '1.01'
}
},
'runtime' => {
'requires' => {
'CPAN::Meta::Requirements' => '2.121',
'CPAN::Meta::YAML' => '0.011',
'Carp' => '0',
'Encode' => '0',
'Exporter' => '0',
'File::Spec' => '0.80',
'JSON::PP' => '2.27300',
'Scalar::Util' => '0',
'perl' => '5.008001',
'strict' => '0',
'version' => '0.88',
'warnings' => '0'
}
},
'test' => {
'recommends' => {
'CPAN::Meta' => '2.120900'
},
'requires' => {
'Data::Dumper' => '0',
'ExtUtils::MakeMaker' => '0',
'File::Basename' => '0',
'File::Spec' => '0.80',
'File::Spec::Functions' => '0',
'File::Temp' => '0.20',
'IO::Dir' => '0',
'JSON::PP' => '2.27300',
'Storable' => '0',
'Test::More' => '0.88',
'lib' => '0',
'overload' => '0',
'perl' => '5.008001',
'utf8' => '0',
'vars' => '0'
}
}
};
$x;
} t/00-report-prereqs.t 0000644 00000012725 15170246504 0010416 0 ustar 00 #!/usr/bin/perl
use strict;
use warnings;
# This test was generated by Dist::Zilla::Plugin::Test::ReportPrereqs 0.025
use Test::More tests => 1;
use ExtUtils::MakeMaker;
use File::Spec;
# from $version::LAX
my $lax_version_re =
qr/(?: undef | (?: (?:[0-9]+) (?: \. | (?:\.[0-9]+) (?:_[0-9]+)? )?
|
(?:\.[0-9]+) (?:_[0-9]+)?
) | (?:
v (?:[0-9]+) (?: (?:\.[0-9]+)+ (?:_[0-9]+)? )?
|
(?:[0-9]+)? (?:\.[0-9]+){2,} (?:_[0-9]+)?
)
)/x;
# hide optional CPAN::Meta modules from prereq scanner
# and check if they are available
my $cpan_meta = "CPAN::Meta";
my $cpan_meta_pre = "CPAN::Meta::Prereqs";
my $HAS_CPAN_META = eval "require $cpan_meta; $cpan_meta->VERSION('2.120900')" && eval "require $cpan_meta_pre"; ## no critic
# Verify requirements?
my $DO_VERIFY_PREREQS = 1;
sub _max {
my $max = shift;
$max = ( $_ > $max ) ? $_ : $max for @_;
return $max;
}
sub _merge_prereqs {
my ($collector, $prereqs) = @_;
# CPAN::Meta::Prereqs object
if (ref $collector eq $cpan_meta_pre) {
return $collector->with_merged_prereqs(
CPAN::Meta::Prereqs->new( $prereqs )
);
}
# Raw hashrefs
for my $phase ( keys %$prereqs ) {
for my $type ( keys %{ $prereqs->{$phase} } ) {
for my $module ( keys %{ $prereqs->{$phase}{$type} } ) {
$collector->{$phase}{$type}{$module} = $prereqs->{$phase}{$type}{$module};
}
}
}
return $collector;
}
my @include = qw(
);
my @exclude = qw(
);
# Add static prereqs to the included modules list
my $static_prereqs = do 't/00-report-prereqs.dd';
# Merge all prereqs (either with ::Prereqs or a hashref)
my $full_prereqs = _merge_prereqs(
( $HAS_CPAN_META ? $cpan_meta_pre->new : {} ),
$static_prereqs
);
# Add dynamic prereqs to the included modules list (if we can)
my ($source) = grep { -f } 'MYMETA.json', 'MYMETA.yml';
if ( $source && $HAS_CPAN_META
&& (my $meta = eval { CPAN::Meta->load_file($source) } )
) {
$full_prereqs = _merge_prereqs($full_prereqs, $meta->prereqs);
}
else {
$source = 'static metadata';
}
my @full_reports;
my @dep_errors;
my $req_hash = $HAS_CPAN_META ? $full_prereqs->as_string_hash : $full_prereqs;
# Add static includes into a fake section
for my $mod (@include) {
$req_hash->{other}{modules}{$mod} = 0;
}
for my $phase ( qw(configure build test runtime develop other) ) {
next unless $req_hash->{$phase};
next if ($phase eq 'develop' and not $ENV{AUTHOR_TESTING});
for my $type ( qw(requires recommends suggests conflicts modules) ) {
next unless $req_hash->{$phase}{$type};
my $title = ucfirst($phase).' '.ucfirst($type);
my @reports = [qw/Module Want Have/];
for my $mod ( sort keys %{ $req_hash->{$phase}{$type} } ) {
next if $mod eq 'perl';
next if grep { $_ eq $mod } @exclude;
my $file = $mod;
$file =~ s{::}{/}g;
$file .= ".pm";
my ($prefix) = grep { -e File::Spec->catfile($_, $file) } @INC;
my $want = $req_hash->{$phase}{$type}{$mod};
$want = "undef" unless defined $want;
$want = "any" if !$want && $want == 0;
my $req_string = $want eq 'any' ? 'any version required' : "version '$want' required";
if ($prefix) {
my $have = MM->parse_version( File::Spec->catfile($prefix, $file) );
$have = "undef" unless defined $have;
push @reports, [$mod, $want, $have];
if ( $DO_VERIFY_PREREQS && $HAS_CPAN_META && $type eq 'requires' ) {
if ( $have !~ /\A$lax_version_re\z/ ) {
push @dep_errors, "$mod version '$have' cannot be parsed ($req_string)";
}
elsif ( ! $full_prereqs->requirements_for( $phase, $type )->accepts_module( $mod => $have ) ) {
push @dep_errors, "$mod version '$have' is not in required range '$want'";
}
}
}
else {
push @reports, [$mod, $want, "missing"];
if ( $DO_VERIFY_PREREQS && $type eq 'requires' ) {
push @dep_errors, "$mod is not installed ($req_string)";
}
}
}
if ( @reports ) {
push @full_reports, "=== $title ===\n\n";
my $ml = _max( map { length $_->[0] } @reports );
my $wl = _max( map { length $_->[1] } @reports );
my $hl = _max( map { length $_->[2] } @reports );
if ($type eq 'modules') {
splice @reports, 1, 0, ["-" x $ml, "", "-" x $hl];
push @full_reports, map { sprintf(" %*s %*s\n", -$ml, $_->[0], $hl, $_->[2]) } @reports;
}
else {
splice @reports, 1, 0, ["-" x $ml, "-" x $wl, "-" x $hl];
push @full_reports, map { sprintf(" %*s %*s %*s\n", -$ml, $_->[0], $wl, $_->[1], $hl, $_->[2]) } @reports;
}
push @full_reports, "\n";
}
}
}
if ( @full_reports ) {
diag "\nVersions for all modules listed in $source (including optional ones):\n\n", @full_reports;
}
if ( @dep_errors ) {
diag join("\n",
"\n*** WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING ***\n",
"The following REQUIRED prerequisites were not satisfied:\n",
@dep_errors,
"\n"
);
}
pass;
# vim: ts=4 sts=4 sw=4 et:
t/README-data.txt 0000644 00000001156 15170246504 0007423 0 ustar 00 There are three test data directories:
- 'data-test': These files are valid META files that test *specific*
conversions and are expected to have specific data in them during
testing. Do not put new test data here unless you are sure it meets all
requirements needed to pass.
- 'data-valid': These files are valid META files. Some may be improved by
the Converter (particularly upconverting from ancient specs).
- 'data-fixable': These files are bad META files that fail validation, but
can be fixed via the Converter.
- 'data-fail': These files are bad META files that fail validation and
can't be fixed.
t/converter-bad.t 0000644 00000005336 15170246504 0007742 0 ustar 00 use strict;
use warnings;
use Test::More 0.88;
use CPAN::Meta;
use CPAN::Meta::Validator;
use CPAN::Meta::Converter;
use File::Spec;
use IO::Dir;
use Parse::CPAN::Meta;
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_DECODER};
my @data_dirs = qw( t/data-valid t/data-fixable );
my @files = sort map {
my $d = $_;
map { "$d/$_" } grep { substr($_,0,1) ne '.' } IO::Dir->new($d)->read
} @data_dirs;
*_spec_version = \&CPAN::Meta::Converter::_extract_spec_version;
#use Data::Dumper;
for my $f ( reverse sort @files ) {
my $path = File::Spec->catfile($f);
my $original = Parse::CPAN::Meta->load_file( $path );
ok( $original, "loaded $f" );
my $original_v = _spec_version($original);
# UPCONVERSION
if ( $original_v lt '2' ) {
my $cmc = CPAN::Meta::Converter->new( $original );
my $converted = $cmc->convert( version => 2 );
is ( _spec_version($converted), 2, "up converted spec version $original_v to spec version 2");
my $cmv = CPAN::Meta::Validator->new( $converted );
ok ( $cmv->is_valid, "up converted META is valid" )
or diag( "ERRORS:\n" . join( "\n", $cmv->errors )
# . "\nMETA:\n" . Dumper($converted)
);
}
# UPCONVERSION - partial
if ( $original_v lt '1.4' ) {
my $cmc = CPAN::Meta::Converter->new( $original );
my $converted = $cmc->convert( version => '1.4' );
is ( _spec_version($converted), 1.4, "up converted spec version $original_v to spec version 1.4");
my $cmv = CPAN::Meta::Validator->new( $converted );
ok ( $cmv->is_valid, "up converted META is valid" )
or diag( "ERRORS:\n" . join( "\n", $cmv->errors )
# . "\nMETA:\n" . Dumper($converted)
);
}
# DOWNCONVERSION - partial
if ( $original_v gt '1.2' ) {
my $cmc = CPAN::Meta::Converter->new( $original );
my $converted = $cmc->convert( version => '1.2' );
is ( _spec_version($converted), '1.2', "down converted spec version $original_v to spec version 1.2");
my $cmv = CPAN::Meta::Validator->new( $converted );
ok ( $cmv->is_valid, "down converted META is valid" )
or diag( "ERRORS:\n" . join( "\n", $cmv->errors )
# . "\nMETA:\n" . Dumper($converted)
);
}
# DOWNCONVERSION
if ( $original_v gt '1.0' ) {
my $cmc = CPAN::Meta::Converter->new( $original );
my $converted = $cmc->convert( version => '1.0' );
is ( _spec_version($converted), '1.0', "down converted spec version $original_v to spec version 1.0");
my $cmv = CPAN::Meta::Validator->new( $converted );
ok ( $cmv->is_valid, "down converted META is valid" )
or diag( "ERRORS:\n" . join( "\n", $cmv->errors )
# . "\nMETA:\n" . Dumper($converted)
);
}
}
done_testing;
# vim: ts=2 sts=2 sw=2 et :
t/converter-fail.t 0000644 00000002250 15170246504 0010117 0 ustar 00 use strict;
use warnings;
use Test::More 0.88;
use CPAN::Meta;
use CPAN::Meta::Validator;
use CPAN::Meta::Converter;
use File::Spec;
use IO::Dir;
use Parse::CPAN::Meta;
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_DECODER};
my $data_dir = IO::Dir->new( 't/data-fail' );
my @files = sort grep { /^\w/ } $data_dir->read;
*_spec_version = \&CPAN::Meta::Converter::_extract_spec_version;
use Data::Dumper;
for my $f ( reverse sort @files ) {
my $path = File::Spec->catfile('t','data-fail',$f);
my $original = Parse::CPAN::Meta->load_file( $path );
ok( $original, "loaded invalid $f" );
my $original_v = _spec_version($original);
# UPCONVERSION
if ( $original_v lt '2' ) {
my $cmc = CPAN::Meta::Converter->new( $original );
my $fixed = eval { $cmc->convert( version => 2 ) };
ok ( $@, "error thrown up converting" );
}
# DOWNCONVERSION
if ( $original_v gt '1.0' ) {
my $cmc = CPAN::Meta::Converter->new( $original );
my $fixed = eval { $cmc->convert( version => '1.0' ) };
ok ( $@, "error thrown down converting" );
}
}
done_testing;
# vim: ts=2 sts=2 sw=2 et :
t/converter-fragments.t 0000644 00000007777 15170246504 0011215 0 ustar 00 use strict;
use warnings;
use Test::More 0.88;
use CPAN::Meta::Converter;
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_DECODER};
my $spec2 = {
version => '2',
url => 'http://search.cpan.org/perldoc?CPAN::Meta::Spec',
};
my @cases = (
#<<< No perltidy
{
label => "v1.4 requires -> v2 prereqs",
from => "1.4",
to => "2",
input => {
requires => {
'File::Spec' => "0.80",
},
},
expect => {
'meta-spec' => $spec2,
prereqs => {
runtime => {
requires => {
'File::Spec' => "0.80",
},
}
}
},
},
{
label => "v1.4 x_custom -> v2 x_custom",
from => "1.4",
to => "2",
input => {
x_authority => 'DAGOLDEN',
},
expect => {
'meta-spec' => $spec2,
x_authority => 'DAGOLDEN',
},
},
{
label => "meta-spec included",
to => "2",
input => {
'meta-spec' => { version => '1.0' },
requires => {
'File::Spec' => "0.80",
},
},
expect => {
'meta-spec' => $spec2,
prereqs => {
runtime => {
requires => {
'File::Spec' => "0.80",
},
}
}
},
},
{
# this is a test of default version and intentionally gives bad
# data that will get dropped by the conversion
label => "default version",
from => "2",
to => "2",
input => {
requires => {
'File::Spec' => "0.80",
},
},
expect => {
'meta-spec' => $spec2,
},
},
{
# fields deprecated from older versions
label => "v1.4 prereq stuff -> v2 prereqs",
from => "1.4",
to => "2",
input => {
configure_requires => {
'File::Spec' => "0.80",
},
build_requires => {
'Scalar::Util' => '1.0',
},
requires => {
'B' => '3.1',
},
recommends => {
'Config' => '4.0',
},
conflicts => {
'File::Temp' => "0.2",
},
},
expect => {
'meta-spec' => $spec2,
prereqs => {
configure => {
requires => {
'File::Spec' => "0.80",
},
},
build => {
requires => {
'Scalar::Util' => '1.0',
},
},
runtime => {
conflicts => {
'File::Temp' => "0.2",
},
requires => {
'B' => '3.1',
},
recommends => {
'Config' => '4.0',
},
},
},
},
},
{
label => "v1.1 license_url: -> v2 license",
from => "1.1",
to => "2",
input => {
license_url => 'http://opensource.org/licenses/Artistic-1.0',
license => 'perl',
},
expect => {
'meta-spec' => $spec2,
license => [ 'perl_5' ],
},
},
);
for my $c (@cases) {
my $cmc = CPAN::Meta::Converter->new(
$c->{input}, $c->{from} ? (default_version => $c->{from} ) : ()
);
my $got = $cmc->upgrade_fragment;
my $exp = $c->{expect};
is_deeply( $got, $exp, $c->{label} )
or diag "GOT:\n", explain($got), "EXPECTED:\n", explain($exp);
}
done_testing;
# vim: ts=8 sts=4 sw=4 et :
t/converter.t 0000644 00000024657 15170246504 0007225 0 ustar 00 use strict;
use warnings;
use Test::More 0.88;
use utf8;
use CPAN::Meta;
use CPAN::Meta::Validator;
use CPAN::Meta::Converter;
use File::Spec;
use File::Basename qw/basename/;
use IO::Dir;
use Parse::CPAN::Meta;
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_DECODER};
# mock file object
package
File::StringObject;
use overload q{""} => sub { ${$_[0]} }, fallback => 1;
sub new {
my ($class, $file) = @_;
bless \$file, $class;
}
package main;
my $data_dir = IO::Dir->new( 't/data-test' );
my @files = sort grep { /^\w/ } $data_dir->read;
*_spec_version = \&CPAN::Meta::Converter::_extract_spec_version;
#use Data::Dumper;
for my $f ( reverse sort @files ) {
note '';
my $path = File::Spec->catfile('t','data-test',$f);
my $original = Parse::CPAN::Meta->load_file( $path );
ok( $original, "loaded $f" );
my $original_v = _spec_version($original);
# UPCONVERSION
{
my $cmc = CPAN::Meta::Converter->new( $original );
my $converted = $cmc->convert( version => 2 );
is ( _spec_version($converted), 2, "up converted spec version $original_v to spec version 2");
my $cmv = CPAN::Meta::Validator->new( $converted );
ok ( $cmv->is_valid, "up converted META is valid" )
or diag( "ERRORS:\n" . join( "\n", $cmv->errors )
# . "\nMETA:\n" . Dumper($converted)
);
}
# UPCONVERSION - partial
if ( _spec_version( $original ) < 2 ) {
my $cmc = CPAN::Meta::Converter->new( $original );
my $converted = $cmc->convert( version => '1.4' );
is ( _spec_version($converted), 1.4, "up converted spec version $original_v to spec version 1.4");
my $cmv = CPAN::Meta::Validator->new( $converted );
ok ( $cmv->is_valid, "up converted META is valid" )
or diag( "ERRORS:\n" . join( "\n", $cmv->errors )
# . "\nMETA:\n" . Dumper($converted)
);
}
# DOWNCONVERSION - partial
if ( _spec_version( $original ) >= 1.2 ) {
my $cmc = CPAN::Meta::Converter->new( $original );
my $converted = $cmc->convert( version => '1.2' );
is ( _spec_version($converted), '1.2', "down converted spec version $original_v to spec version 1.2");
my $cmv = CPAN::Meta::Validator->new( $converted );
ok ( $cmv->is_valid, "down converted META is valid" )
or diag( "ERRORS:\n" . join( "\n", $cmv->errors )
# . "\nMETA:\n" . Dumper($converted)
);
if (_spec_version( $original ) == 2) {
is_deeply(
$converted->{build_requires},
{
'Test::More' => '0.88',
'Build::Requires' => '1.1',
'Test::Requires' => '1.2',
},
"downconversion from 2 merge test and build requirements",
);
}
}
# DOWNCONVERSION
{
my $cmc = CPAN::Meta::Converter->new( $original );
my $converted = $cmc->convert( version => '1.0' );
is ( _spec_version($converted), '1.0', "down converted spec version $original_v to spec version 1.0");
my $cmv = CPAN::Meta::Validator->new( $converted );
ok ( $cmv->is_valid, "down converted META is valid" )
or diag( "ERRORS:\n" . join( "\n", $cmv->errors )
# . "\nMETA:\n" . Dumper($converted)
);
unless ($original_v eq '1.0') {
like ( $converted->{generated_by},
qr(\Q$original->{generated_by}\E, CPAN::Meta::Converter version \S+$),
"added converter mark to generated_by",
);
}
}
}
# specific test for custom key handling
{
my $path = File::Spec->catfile('t','data-test','META-1_4.yml');
my $original = Parse::CPAN::Meta->load_file( $path );
ok( $original, "loaded META-1_4.yml" );
my $cmc = CPAN::Meta::Converter->new( $original );
my $up_converted = $cmc->convert( version => 2 );
ok ( $up_converted->{x_whatever} && ! $up_converted->{'x-whatever'},
"up converted 'x-' to 'x_'"
);
ok ( $up_converted->{x_whatelse},
"up converted 'x_' as 'x_'"
);
ok ( $up_converted->{x_WhatNow} && ! $up_converted->{XWhatNow},
"up converted 'XFoo' to 'x_Foo'"
) or diag join("\n", keys %$up_converted);
}
# specific test for custom key handling
{
my $path = File::Spec->catfile('t','data-test','META-2.json');
my $original = Parse::CPAN::Meta->load_file( $path );
ok( $original, "loaded META-2.json" );
my $cmc = CPAN::Meta::Converter->new( $original );
my $down_converted = $cmc->convert( version => 1.4 );
ok ( $down_converted->{x_whatever},
"down converted 'x_' as 'x_'"
);
}
# specific test for generalization of unclear licenses
{
my $path = File::Spec->catfile('t','data-test','gpl-1_4.yml');
my $original = Parse::CPAN::Meta->load_file( $path );
ok( $original, "loaded gpl-1_4.yml" );
my $cmc = CPAN::Meta::Converter->new( $original );
my $up_converted = $cmc->convert( version => 2 );
is_deeply ( $up_converted->{license},
[ "open_source" ],
"up converted 'gpl' to 'open_source'"
);
}
# specific test for upconverting resources
{
my $path = File::Spec->catfile('t','data-test','resources.yml');
my $original = Parse::CPAN::Meta->load_file( $path );
ok( $original, "loaded resources.yml" );
my $cmc = CPAN::Meta::Converter->new( $original );
my $converted = $cmc->convert( version => 2 );
is_deeply(
$converted->{resources},
{ x_MailingList => 'http://groups.google.com/group/www-mechanize-users',
x_Repository => 'http://code.google.com/p/www-mechanize/source',
homepage => 'http://code.google.com/p/www-mechanize/',
bugtracker => {web => 'http://code.google.com/p/www-mechanize/issues/list',},
license => ['http://dev.perl.org/licenses/'],
},
"upconversion of resources"
);
}
# specific test for round-tripping resources
{
my $path = File::Spec->catfile('t','data-test','resources.yml');
my $original = Parse::CPAN::Meta->load_file( $path );
ok( $original, "loaded resources.yml" );
my $cmc1 = CPAN::Meta::Converter->new( $original );
my $converted = $cmc1->convert( version => 2 );
my $cmc2 = CPAN::Meta::Converter->new( $converted );
my $roundtrip = $cmc2->convert( version => 1.4 );
is_deeply(
$roundtrip->{resources},
$original->{resources},
"round-trip of resources (1.4->2->1.4)"
);
}
# specific test for object conversion
{
my $path = File::Spec->catfile('t','data-test','resources.yml');
my $original = Parse::CPAN::Meta->load_file( $path );
ok( $original, "loaded resources.yml" );
$original->{version} = version->new("1.64");
$original->{no_index}{file} = File::StringObject->new(".gitignore");
pass( "replaced some data fields with objects" );
my $cmc = CPAN::Meta::Converter->new( $original );
ok( my $converted = $cmc->convert( version => 2 ), "conversion successful" );
}
# specific test for UTF-8 handling
{
my $path = File::Spec->catfile('t','data-test','unicode.yml');
my $original = CPAN::Meta->load_file( $path )
or die "Couldn't load $path";
ok( $original, "unicode.yml" );
my @authors = $original->authors;
like( $authors[0], qr/Williåms/, "Unicode characters preserved in authors" );
}
# specific test for version ranges
{
my @prereq_keys = qw(
prereqs requires build_requires configure_requires
recommends conflicts
);
for my $case ( qw/ 2 1_4 / ) {
my $suffix = $case eq 2 ? "$case.json" : "$case.yml";
my $version = $case;
$version =~ tr[_][.];
my $path = File::Spec->catfile('t','data-test','version-ranges-' . $suffix);
my $original = Parse::CPAN::Meta->load_file( $path );
ok( $original, "loaded " . basename $path );
my $cmc = CPAN::Meta::Converter->new( $original );
my $converted = $cmc->convert( version => $version );
for my $h ( $original, $converted ) {
delete $h->{generated_by};
delete $h->{'meta-spec'}{url};
for my $k ( @prereq_keys ) {
_normalize_reqs($h->{$k}) if exists $h->{$k};
}
}
is_deeply( $converted, $original, "version ranges preserved in conversion" );
}
}
# specific test for version numbers
{
my $path = File::Spec->catfile('t','data-test','version-not-normal.json');
my $original = Parse::CPAN::Meta->load_file( $path );
ok( $original, "loaded " . basename $path );
my $cmc = CPAN::Meta::Converter->new( $original );
my $converted = $cmc->convert( version => 2 );
is( $converted->{prereqs}{runtime}{requires}{'File::Find'}, "v0.1.0", "normalize v0.1");
is( $converted->{prereqs}{runtime}{requires}{'File::Path'}, "v1.0.0", "normalize v1.0.0");
}
# specific test for missing provides version
{
my $path = File::Spec->catfile('t','data-test','provides-version-missing.json');
my $original = Parse::CPAN::Meta->load_file( $path );
ok( $original, "loaded " . basename $path );
my $cmc = CPAN::Meta::Converter->new( $original );
my $converted = $cmc->convert( version => 2 );
is_deeply( $converted->{provides}{"Foo::Bar"}, { file => "lib/Foo/Bar.pm", version => "0.27_02" },
"Foo::Bar provides correct"
);
is_deeply( $converted->{provides}{"Foo::Bar::Blah"}, { file => "lib/Foo/Bar/Blah.pm" },
"Foo::Bar::Blah provides correct"
);
is_deeply( $converted->{provides}{"Foo::Bar::Baz"}, { file => "lib/Foo/Bar/Baz.pm", version => "0.3" },
"Foo::Bar provides correct"
);
}
# CMR standardizes stuff in a way that makes it hard to test original vs final
# so we remove spaces and >= to make them compare the same
sub _normalize_reqs {
my $hr = shift;
for my $k ( keys %$hr ) {
if (ref $hr->{$k} eq 'HASH') {
_normalize_reqs($hr->{$k});
}
elsif ( ! ref $hr->{$k} ) {
$hr->{$k} =~ s{\s+}{}g;
$hr->{$k} =~ s{>=\s*}{}g;
}
}
}
# specific test for multiple licenses
{
my $path = File::Spec->catfile('t','data-test','META-2.json');
my $original = Parse::CPAN::Meta->load_file( $path );
ok( $original, "loaded META-2.json" );
my $cmc = CPAN::Meta::Converter->new( $original );
my $cleaned_up = $cmc->convert( version => "2" );
is_deeply(
$cleaned_up->{license},
[ 'perl_5', 'bsd' ],
"multiple license preserved (v2)"
);
$cleaned_up = $cmc->convert( version => "1.4" );
is(
$cleaned_up->{license},
'open_source',
"multiple license converted to open_source (v1.4)"
);
}
# specific test for preserving release_status on upconversion
{
my $path = File::Spec->catfile('t','data-test','preserve-release-status.yml');
my $original = Parse::CPAN::Meta->load_file( $path );
ok( $original, "loaded META-2.json" );
my $cmc = CPAN::Meta::Converter->new( $original );
my $cleaned_up = $cmc->convert( version => "2" );
is( $cleaned_up->{release_status}, 'unstable', "release_status preserved" );
}
done_testing;
# vim: ts=2 sts=2 sw=2 et:
t/load-bad.t 0000644 00000001445 15170246504 0006647 0 ustar 00 use strict;
use warnings;
use Test::More 0.88;
use CPAN::Meta;
use File::Spec;
use IO::Dir;
sub _slurp { do { local(@ARGV,$/)=shift(@_); <> } }
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_DECODER};
my $data_dir = IO::Dir->new( 't/data-fixable' );
my @files = sort grep { /^\w/ } $data_dir->read;
for my $f ( sort @files ) {
my $path = File::Spec->catfile('t','data-fixable',$f);
ok( eval { CPAN::Meta->load_file( $path ) }, "load_file('$f')" ) or diag $@;
my $string = _slurp($path);
my $method = $path =~ /\.json/ ? "load_json_string" : "load_yaml_string";
ok( eval { CPAN::Meta->$method( $string, { fix_errors => 1 } ) }, "$method(slurp('$f'))" ) or diag $@;
}
done_testing;
# vim: ts=2 sts=2 sw=2 et:
t/merge.t 0000644 00000013362 15170246504 0006304 0 ustar 00 use strict;
use warnings;
use Test::More;
use CPAN::Meta;
use CPAN::Meta::Merge;
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_DECODER};
my %base = (
abstract => 'This is a test',
author => ['A.U. Thor'],
generated_by => 'Myself',
license => [ 'perl_5' ],
resources => {
license => [ 'http://dev.perl.org/licenses/' ],
bugtracker => { web => 'https://rt.cpan.org/Dist/Display.html?Foo-Bar' },
},
prereqs => {
runtime => {
requires => {
Foo => '0',
},
},
},
dynamic_config => 0,
provides => {
Baz => {
file => 'lib/Baz.pm',
},
},
'meta-spec' => {
url => "http://search.cpan.org/perldoc?CPAN::Meta::Spec",
version => 2,
},
);
my %first = (
author => [ 'I.M. Poster' ],
generated_by => 'Some other guy',
license => [ 'bsd' ],
resources => {
license => [ 'http://opensource.org/licenses/bsd-license.php' ],
},
prereqs => {
runtime => {
requires => {
Foo => '< 1',
},
recommends => {
Bar => '3.14',
},
},
test => {
requires => {
'Test::Bar' => 0,
},
},
},
dynamic_config => 1,
provides => {
Quz => {
file => 'lib/Quz.pm',
},
},
);
my %first_expected = (
abstract => 'This is a test',
author => [ 'A.U. Thor', 'I.M. Poster' ],
generated_by => 'Myself, Some other guy',
license => [ 'perl_5', 'bsd' ],
resources => {
license => [ 'http://dev.perl.org/licenses/', 'http://opensource.org/licenses/bsd-license.php' ],
bugtracker => { web => 'https://rt.cpan.org/Dist/Display.html?Foo-Bar' },
},
prereqs => {
runtime => {
requires => {
Foo => '>= 0, < 1',
},
recommends => {
Bar => '3.14',
},
},
test => {
requires => {
'Test::Bar' => 0,
},
},
},
provides => {
Baz => {
file => 'lib/Baz.pm',
},
Quz => {
file => 'lib/Quz.pm',
},
},
dynamic_config => 1,
'meta-spec' => {
url => "http://search.cpan.org/perldoc?CPAN::Meta::Spec",
version => 2,
},
);
my %provides_merge_expected = (
abstract => 'This is a test',
author => ['A.U. Thor'],
generated_by => 'Myself',
license => [ 'perl_5' ],
resources => {
license => [ 'http://dev.perl.org/licenses/' ],
bugtracker => { web => 'https://rt.cpan.org/Dist/Display.html?Foo-Bar' },
},
prereqs => {
runtime => {
requires => {
Foo => '0',
},
},
},
dynamic_config => 0,
provides => {
Baz => {
file => 'lib/Baz.pm',
version => '0.001', # same as %base, but for this extra key
},
},
'meta-spec' => {
url => "http://search.cpan.org/perldoc?CPAN::Meta::Spec",
version => 2,
},
);
my $merger = CPAN::Meta::Merge->new(default_version => '2');
my $first_result = $merger->merge(\%base, \%first);
is_deeply($first_result, \%first_expected, 'First result is as expected');
is_deeply($merger->merge(\%base, { abstract => 'This is a test' }), \%base, 'Can merge in identical abstract');
is(
eval { $merger->merge(\%base, { abstract => 'And now for something else' }) },
undef,
'Trying to merge different abstract gives an exception',
);
like $@, qr/^Can't merge attribute abstract/, 'Exception looks right';
is(
eval { $merger->merge(\%base, { resources => { bugtracker => { web => 'http://foo.com' } } } ) },
undef,
'Trying to merge a different bugtracker URL gives an exception',
);
like $@, qr/^Duplication of element resources\.bugtracker\.web /, 'Exception looks right';
is(
eval { $merger->merge(\%base, { provides => { Baz => { file => 'Baz.pm' } } }) },
undef,
'Trying to merge different provides.$module.file gives an exception',
);
like $@, qr/^Duplication of element provides\.Baz\.file /, 'Exception looks right';
my $provides_result = $merger->merge(\%base, { provides => { Baz => { file => 'lib/Baz.pm', version => '0.001' } } });
is_deeply(
$provides_result,
\%provides_merge_expected,
'Trying to merge a new key for provides.$module is permitted; identical values are preserved',
);
my $extra_merger = CPAN::Meta::Merge->new(
default_version => '2',
extra_mappings => {
'x_toolkit' => 'set_addition',
'x_meta_meta' => {
name => 'identical',
tags => 'set_addition',
}
}
);
my $extra_results = $extra_merger->merge(\%base, {
x_toolkit => [ 'marble' ],
x_meta_meta => {
name => 'Test',
tags => [ 'Testing' ],
}
},
{ x_toolkit => [ 'trike'],
x_meta_meta => {
name => 'Test',
tags => [ 'TDD' ],
}
}
);
my $expected_nested_extra = {
name => 'Test',
tags => [ 'Testing', 'TDD' ],
};
is_deeply($extra_results->{x_toolkit}, [ 'marble', 'trike' ], 'Extra mapping fields are merged');
is_deeply($extra_results->{x_meta_meta}, $expected_nested_extra, 'Nested extra mapping fields are merged' );
my $adds_to = sub {
my ($left, $right, $path) = @_;
if ($right !~ /^\Q$left\E/) {
die sprintf "Can't merge attribute %s: '%s' does not start with '%s'", join('.', @{$path}), $right, $left;
}
return $right;
};
$extra_merger = CPAN::Meta::Merge->new(default_version => '2', extra_mappings => { 'abstract' => \&$adds_to } );
my $extra_results2 = $extra_merger->merge({ abstract => 'This is a test.'}, { abstract => 'This is a test. Includes more detail..' } );
is($extra_results2->{abstract}, 'This is a test. Includes more detail..', 'Extra mapping fields overwrite existing mappings');
my $extra_failure = eval { $extra_merger->merge({ abstract => 'This is a test.'}, { abstract => 'This is a better test.' } ) };
is($extra_failure, undef, 'Extra mapping produces a failure');
like $@, qr/does not start with/, 'Exception looks right';
# issue 67
@base{qw/name version release_status/} = qw/Foo-Bar 0.01 testing/;
my $base_obj = CPAN::Meta->create(\%base);
ok my $first_result_obj = $merger->merge($base_obj, \%first), 'merging CPAN::Meta objects succeeds';
done_testing();
# vim: ts=4 sts=4 sw=4 tw=78 noet :
t/meta-obj.t 0000644 00000015174 15170246504 0006706 0 ustar 00 use strict;
use warnings;
use Test::More 0.88;
use CPAN::Meta;
use Storable qw(dclone);
use Scalar::Util qw(blessed);
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_DECODER};
my $distmeta = {
name => 'Module-Build',
abstract => 'Build and install Perl modules',
description => "Module::Build is a system for building, testing, "
. "and installing Perl modules. It is meant to be an "
. "alternative to ExtUtils::MakeMaker... blah blah blah",
version => '0.36',
author => [
'Ken Williams <kwilliams@cpan.org>',
'Module-Build List <module-build@perl.org>', # additional contact
],
release_status => 'stable',
license => [ 'perl_5' ],
prereqs => {
runtime => {
requires => {
'perl' => '5.006',
'Config' => '0',
'Cwd' => '0',
'Data::Dumper' => '0',
'ExtUtils::Install' => '0',
'File::Basename' => '0',
'File::Compare' => '0',
'File::Copy' => '0',
'File::Find' => '0',
'File::Path' => '0',
'File::Spec' => '0',
'IO::File' => '0',
},
recommends => {
'Archive::Tar' => '1.00',
'ExtUtils::Install' => '0.3',
'ExtUtils::ParseXS' => '2.02',
'Pod::Text' => '0',
'YAML' => '0.35',
},
},
build => {
requires => {
'Test::More' => '0',
},
}
},
resources => {
license => ['http://dev.perl.org/licenses/'],
},
optional_features => {
domination => {
description => 'Take over the world',
prereqs => {
develop => { requires => { 'Genius::Evil' => '1.234' } },
runtime => { requires => { 'Machine::Weather' => '2.0' } },
},
},
},
dynamic_config => 1,
keywords => [ qw/ toolchain cpan dual-life / ],
'meta-spec' => {
version => '2',
url => 'http://search.cpan.org/perldoc?CPAN::Meta::Spec',
},
generated_by => 'Module::Build version 0.36',
x_authority => 'cpan:FLORA',
X_deep => { deep => 'structure' },
};
my $meta = CPAN::Meta->new(dclone $distmeta);
is(
blessed($meta->as_struct),
undef,
"the result of ->as_struct is unblessed",
);
is_deeply( $meta->as_struct, $distmeta, "->as_struct (deep comparison)" );
isnt( $meta->as_struct, $distmeta, "->as_struct (is a deep clone)" );
my $old_copy = $meta->as_struct( {version => "1.4"} );
is( $old_copy->{'meta-spec'}{version}, "1.4", "->as_struct (downconversion)" );
isnt( $meta->resources, $meta->{resources}, "->resource (map values are deep cloned)");
is($meta->name, 'Module-Build', '->name');
is($meta->abstract, 'Build and install Perl modules', '->abstract');
like($meta->description, qr/Module::Build.+blah blah blah/, '->description');
is($meta->version, '0.36', '->version');
ok($meta->dynamic_config, "->dynamic_config");
is_deeply(
[ $meta->author ],
[
'Ken Williams <kwilliams@cpan.org>',
'Module-Build List <module-build@perl.org>',
],
'->author',
);
is_deeply(
[ $meta->authors ],
[
'Ken Williams <kwilliams@cpan.org>',
'Module-Build List <module-build@perl.org>',
],
'->authors',
);
is_deeply(
[ $meta->license ],
[ qw(perl_5) ],
'->license',
);
is_deeply(
[ $meta->licenses ],
[ qw(perl_5) ],
'->licenses',
);
is_deeply(
[ $meta->keywords ],
[ qw/ toolchain cpan dual-life / ],
'->keywords',
);
is_deeply(
$meta->resources,
{ license => [ 'http://dev.perl.org/licenses/' ] },
'->resources',
);
is_deeply(
$meta->meta_spec,
{
version => '2',
url => 'http://search.cpan.org/perldoc?CPAN::Meta::Spec',
},
'->meta_spec',
);
is($meta->meta_spec_version, '2', '->meta_spec_version');
like($meta->generated_by, qr/Module::Build version 0.36/, '->generated_by');
my $basic = $meta->effective_prereqs;
is_deeply(
$basic->as_string_hash,
$distmeta->{prereqs},
"->effective_prereqs()"
);
is_deeply( [ sort $meta->custom_keys ] , [ 'X_deep', 'x_authority' ],
"->custom_keys"
);
is( $meta->custom('x_authority'), 'cpan:FLORA', "->custom(X)" );
is_deeply( $meta->custom('X_deep'), $distmeta->{'X_deep'},
"->custom(X) [is_deeply]"
);
isnt( $meta->custom('X_deep'), $distmeta->{'X_deep'},
"->custom(x) [is a deep clone]"
);
my $with_features = $meta->effective_prereqs([ qw(domination) ]);
is_deeply(
$with_features->as_string_hash,
{
develop => { requires => { 'Genius::Evil' => '1.234' } },
runtime => {
requires => {
'perl' => '5.006',
'Config' => '0',
'Cwd' => '0',
'Data::Dumper' => '0',
'ExtUtils::Install' => '0',
'File::Basename' => '0',
'File::Compare' => '0',
'File::Copy' => '0',
'File::Find' => '0',
'File::Path' => '0',
'File::Spec' => '0',
'IO::File' => '0',
'Machine::Weather' => '2.0',
},
recommends => {
'Archive::Tar' => '1.00',
'ExtUtils::Install' => '0.3',
'ExtUtils::ParseXS' => '2.02',
'Pod::Text' => '0',
'YAML' => '0.35',
},
},
build => {
requires => {
'Test::More' => '0',
},
}
},
"->effective_prereqs([ qw(domination) ])"
);
my $chk_feature = sub {
my $feature = shift;
isa_ok($feature, 'CPAN::Meta::Feature');
is($feature->identifier, 'domination', '$feature->identifier');
is($feature->description, 'Take over the world', '$feature->description');
is_deeply(
$feature->prereqs->as_string_hash,
{
develop => { requires => { 'Genius::Evil' => '1.234' } },
runtime => { requires => { 'Machine::Weather' => '2.0' } },
},
'$feature->prereqs',
);
};
my @features = $meta->features;
is(@features, 1, "we got one feature");
$chk_feature->($features[0]);
$chk_feature->( $meta->feature('domination') );
sub read_file {
my $filename = shift;
open my $fh, '<', $filename;
local $/;
my $string = <$fh>;
$string =~ s/\$VERSION/$CPAN::Meta::VERSION/g;
$string;
}
sub clean_backends {
my $string = shift;
$string =~ s{"?generated_by.*}{};
$string =~ s{"?x_serialization_backend.*}{};
return $string;
}
is(
clean_backends($meta->as_string()),
clean_backends(read_file('t/data-valid/META-2.json')),
'as_string with no arguments defaults to version 2 and JSON',
);
is(
clean_backends($meta->as_string({ version => 2 })),
clean_backends(read_file('t/data-valid/META-2.json')),
'as_string using version 2 defaults to JSON',
);
is(
clean_backends($meta->as_string({ version => 1.4 })),
clean_backends(read_file('t/data-valid/META-1_4.yml')),
'as_string using version 1.4 defaults to YAML',
);
done_testing;
# vim: ts=2 sts=2 sw=2 et :
t/no-index.t 0000644 00000003504 15170246504 0006723 0 ustar 00 use strict;
use warnings;
use Test::More 0.88;
use CPAN::Meta;
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_DECODER};
my %distmeta = (
name => 'Module-Billed',
abstract => 'inscrutable',
version => '1',
author => [ 'Joe' ],
release_status => 'stable',
license => [ 'perl_5' ],
'meta-spec' => {
version => '2',
url => 'http://search.cpan.org/perldoc?CPAN::Meta::Spec',
},
dynamic_config => 1,
generated_by => 'Module::Build version 0.36',
);
{
my $meta = CPAN::Meta->new({ %distmeta });
ok(
$meta->should_index_package('Foo::Bar::Baz'),
'we index any old package, without a no_index rule'
);
ok(
$meta->should_index_file('lib/Foo/Bar/Baz.pm'),
'we index any old file, without a no_index rule'
);
}
{
my $meta = CPAN::Meta->new({
%distmeta,
no_index => {
package => [ 'Foo::Bar' ],
namespace => [ 'Foo::Bar::Baz' ],
}
});
ok(
! $meta->should_index_package('Foo::Bar'),
'exclude a specific package'
);
ok(
$meta->should_index_package('Foo::Bar::Baz'),
'namespace X does not exclude package X'
);
ok(
! $meta->should_index_package('Foo::Bar::Baz::Quux'),
'exclude something under a namespace'
);
}
{
my $meta = CPAN::Meta->new({
%distmeta,
no_index => {
file => [ 'lib/Foo/Bar.pm' ],
directory => [ 'lib/Foo/Bar/Baz' ],
}
});
ok(
! $meta->should_index_file('lib/Foo/Bar.pm'),
'exclude a specific file'
);
ok(
$meta->should_index_file('lib/Foo/Bar/Baz.pm'),
'do not exclude a file with a name like an excluded dir',
);
ok(
! $meta->should_index_file('lib/Foo/Bar/Baz/Quux.pm'),
'exclude something under a directory'
);
}
done_testing;
# vim: ts=2 sts=2 sw=2 et :
t/optional_feature-merge.t 0000644 00000006310 15170246504 0011635 0 ustar 00 use strict;
use warnings;
use Test::More;
use CPAN::Meta;
use CPAN::Meta::Merge;
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_DECODER};
my %base = (
abstract => 'This is a test',
author => ['A.U. Thor'],
generated_by => 'Myself',
license => [ 'perl_5' ],
resources => {
license => [ 'http://dev.perl.org/licenses/' ],
},
prereqs => {
runtime => {
requires => {
Foo => '0',
},
},
},
dynamic_config => 0,
provides => {
Baz => {
file => 'lib/Baz.pm',
},
},
'meta-spec' => {
url => "http://search.cpan.org/perldoc?CPAN::Meta::Spec",
version => 2,
},
);
my $fragment1 = {
'optional_features' => {
'FeatureName' => {
'description' => 'desc',
'x_default' => 1,
'prereqs' => { 'runtime' => { 'requires' => { 'A' => '0' } } }
}
}
};
my $fragment2 = {
'optional_features' => {
'FeatureName' => {
'description' => 'desc',
'prereqs' => { 'test' => { 'requires' => { 'B' => '0' } } }
}
}
};
my $merger = CPAN::Meta::Merge->new(default_version => "2");
my $meta1 = $merger->merge(\%base, $fragment1);
is_deeply(
$meta1,
{
%base,
%$fragment1,
},
'merged first optional_feature fragment into base',
);
my $meta2 = $merger->merge($meta1, $fragment2);
is_deeply(
$meta2,
{
%base,
'optional_features' => {
'FeatureName' => {
'description' => 'desc',
'x_default' => 1,
'prereqs' => {
'runtime' => { 'requires' => { 'A' => '0' } },
'test' => { 'requires' => { 'B' => '0' } },
}
}
}
},
'merged second optional_feature fragment into the first',
);
my $fragment3 = {
'optional_features' => {
'FeatureName' => {
'description' => 'other desc',
'prereqs' => { 'test' => { 'requires' => { 'B' => '0' } } }
}
}
};
is( eval { $merger->merge($meta1, $fragment3) }, undef, 'Trying to merge optional_features with same feature name and different descriptions gives an exception');
like $@, qr/^Cannot merge two optional_features named 'FeatureName' with different 'description' values/, 'Exception looks right';
my $fragment4 = {
'optional_features' => {
'FeatureName' => {
'description' => 'desc',
'x_default' => 0,
'prereqs' => { 'test' => { 'requires' => { 'B' => '0' } } }
}
}
};
is( eval { $merger->merge($meta1, $fragment4) }, undef, 'Trying to merge optional_features with same feature name and differences in other keys gives an exception');
like $@, qr/^Cannot merge two optional_features named 'FeatureName' with different 'x_default' values/, 'Exception looks right';
my $fragment5 = {
'optional_features' => {
'Another FeatureName' => {
'description' => 'desc',
'prereqs' => { 'test' => { 'requires' => { 'B' => '0' } } }
}
}
};
my $meta5 = $merger->merge($meta1, $fragment5);
is_deeply(
$meta5,
{
%base,
'optional_features' => {
'FeatureName' => {
'description' => 'desc',
'x_default' => 1,
'prereqs' => { 'runtime' => { 'requires' => { 'A' => '0' } } },
},
'Another FeatureName' => {
'description' => 'desc',
'prereqs' => { 'test' => { 'requires' => { 'B' => '0' } } },
}
}
},
'can merge optional_features with different names without collisions',
);
done_testing;
# vim: ts=4 sts=4 sw=4 noet :
t/prereqs-finalize.t 0000644 00000004365 15170246504 0010470 0 ustar 00 use strict;
use warnings;
use Test::More 0.88;
use CPAN::Meta::Prereqs;
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_DECODER};
sub dies_ok (&@) {
my ($code, $qr, $comment) = @_;
if (eval { $code->(); 1 }) {
fail("$comment: did not die");
} else {
like($@, $qr, $comment);
}
}
my $prereqs_struct = {
runtime => {
requires => {
'Config' => '1.234',
'Cwd' => '876.5',
'IO::File' => 0,
'perl' => '5.005_03',
},
recommends => {
'Pod::Text' => 0,
'YAML' => '0.35',
},
},
build => {
requires => {
'Test' => 0,
},
}
};
my $prereqs = CPAN::Meta::Prereqs->new($prereqs_struct);
isa_ok($prereqs, 'CPAN::Meta::Prereqs');
$prereqs->finalize;
ok($prereqs->is_finalized, 'cloned obj is not finalized');
is_deeply($prereqs->as_string_hash, $prereqs_struct, '...and still round-trip');
$prereqs->requirements_for(qw(runtime requires))->add_minimum(Cwd => 10);
pass('...we can add a minimum if it has no effect');
dies_ok
{ $prereqs->requirements_for(qw(runtime requires))->add_minimum(Cwd => 1000) }
qr{finalized req},
'...but we die if it would alter a finalized prereqs';
$prereqs->requirements_for(qw(develop suggests));
pass('...we can get a V:R object for a previously unconfigured phase');
dies_ok
{ $prereqs->requirements_for(qw(develop suggests))->add_minimum(Foo => 1) }
qr{finalized req},
'...but we die if we try to put anything in it';
my $clone = $prereqs->clone;
isa_ok($clone, 'CPAN::Meta::Prereqs', 'cloned prereqs obj');
ok(! $clone->is_finalized, 'cloned obj is not finalized');
is_deeply($clone->as_string_hash, $prereqs_struct, '...it still round-trips');
$clone->requirements_for(qw(runtime requires))->add_minimum(Cwd => 10);
pass('...we can add minimum if it has no effect');
$clone->requirements_for(qw(runtime requires))->add_minimum(Cwd => 1000);
pass('...or if it has an effect');
$clone->requirements_for(qw(develop suggests));
pass('...we can get a V:R object for a previously unconfigured phase');
$clone->requirements_for(qw(develop suggests))->add_minimum(Foo => 1);
pass('...and we can add stuff to it');
done_testing;
# vim: ts=2 sts=2 sw=2 et :
t/prereqs-merge.t 0000644 00000004571 15170246504 0007765 0 ustar 00 use strict;
use warnings;
use Test::More 0.88;
use CPAN::Meta::Prereqs;
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_DECODER};
my $prereq_struct_1 = {
runtime => {
requires => {
'Config' => 0,
'Cwd' => 0,
'perl' => '5.005_03',
},
recommends => {
'Pod::Text' => 0,
'YAML' => 0.35,
},
},
build => {
requires => {
'Test' => 0,
},
x_type => {
'Config' => 1,
},
},
x_phase => {
x_type => {
'POSIX' => '1.23',
},
},
};
my $prereq_1 = CPAN::Meta::Prereqs->new($prereq_struct_1);
isa_ok($prereq_1, 'CPAN::Meta::Prereqs', 'first prereq');
is_deeply($prereq_1->as_string_hash, $prereq_struct_1, '...and it round trips');
my $prereq_struct_2 = {
develop => {
requires => {
'Dist::Mothra' => '1.230',
},
suggests => {
'Blort::Blortex' => '== 10.20',
},
},
runtime => {
requires => {
'Config' => 1,
'perl' => '< 6',
},
},
build => {
suggests => {
'Module::Build::Bob' => '20100101',
},
},
x_phase => {
requires => {
'JSON::PP' => '2.34',
},
},
};
my $prereq_2 = CPAN::Meta::Prereqs->new($prereq_struct_2);
isa_ok($prereq_2, 'CPAN::Meta::Prereqs', 'second prereq');
is_deeply($prereq_1->as_string_hash, $prereq_struct_1, '...and it round trips');
my $merged = $prereq_1->with_merged_prereqs($prereq_2);
my $want = {
develop => {
requires => {
'Dist::Mothra' => '1.230',
},
suggests => {
'Blort::Blortex' => '== 10.20',
},
},
runtime => {
requires => {
'Config' => 1,
'Cwd' => 0,
'perl' => '>= 5.005_03, < 6',
},
recommends => {
'Pod::Text' => 0,
'YAML' => 0.35,
},
},
build => {
requires => {
'Test' => 0,
},
suggests => {
'Module::Build::Bob' => '20100101',
},
x_type => {
'Config' => 1,
},
},
x_phase => {
requires => {
'JSON::PP' => '2.34',
},
x_type => {
'POSIX' => '1.23',
},
},
};
is_deeply(
$merged->as_string_hash,
$want,
"we get the right result of merging two prereqs",
);
is_deeply(
$prereq_2->with_merged_prereqs($prereq_1)->as_string_hash,
$want,
"...and the merge works the same in reverse",
);
done_testing;
# vim: ts=2 sts=2 sw=2 et :
t/prereqs.t 0000644 00000007234 15170246504 0006667 0 ustar 00 use strict;
use warnings;
use Test::More 0.88;
use CPAN::Meta::Prereqs;
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_DECODER};
my $prereq_struct = {
runtime => {
requires => {
'Config' => 0,
'Cwd' => 0,
'Data::Dumper' => 0,
'ExtUtils::Install' => 0,
'File::Basename' => 0,
'File::Compare' => 0,
'File::Copy' => 0,
'File::Find' => 0,
'File::Path' => 0,
'File::Spec' => 0,
'IO::File' => 0,
'perl' => '5.005_03',
},
recommends => {
'Archive::Tar' => '1.00',
'ExtUtils::Install' => 0.3,
'ExtUtils::ParseXS' => 2.02,
'Pod::Text' => 0,
'YAML' => 0.35,
},
},
build => {
requires => {
'Test' => 0,
},
x_type => {
'Config' => 1,
},
},
x_phase => {
requires => {
'JSON::PP' => '2.34',
},
x_type => {
'POSIX' => '1.23',
},
},
};
my $prereq = CPAN::Meta::Prereqs->new($prereq_struct);
isa_ok($prereq, 'CPAN::Meta::Prereqs');
is_deeply($prereq->as_string_hash, $prereq_struct, "round-trip okay");
{
my $req = $prereq->requirements_for(qw(runtime requires));
my @req_mod = $req->required_modules;
ok(
(grep { 'Cwd' eq $_ } @req_mod),
"we got the runtime requirements",
);
ok(
(! grep { 'YAML' eq $_ } @req_mod),
"...but not the runtime recommendations",
);
ok(
(! grep { 'Test' eq $_ } @req_mod),
"...nor the build requirements",
);
}
{
my $req = $prereq->requirements_for(qw(runtime requires));
my $rec = $prereq->requirements_for(qw(runtime recommends));
my $merged = $req->clone->add_requirements($rec);
my @req_mod = $merged->required_modules;
ok(
(grep { 'Cwd' eq $_ } @req_mod),
"we got the runtime requirements",
);
ok(
(grep { 'YAML' eq $_ } @req_mod),
"...and the runtime recommendations",
);
ok(
(! grep { 'Test' eq $_ } @req_mod),
"...but not the build requirements",
);
}
{
my $req = $prereq->requirements_for(qw(runtime suggests));
my @req_mod = $req->required_modules;
is(@req_mod, 0, "empty set of runtime/suggests requirements");
}
{
my $req = $prereq->requirements_for(qw(develop suggests));
my @req_mod = $req->required_modules;
is(@req_mod, 0, "empty set of develop/suggests requirements");
}
{
my $new_prereq = CPAN::Meta::Prereqs->new;
$new_prereq
->requirements_for(qw(runtime requires))
->add_minimum(Foo => '1.000');
$new_prereq
->requirements_for(qw(runtime requires))
->add_minimum(Bar => '2.976');
$new_prereq
->requirements_for(qw(test requires))
->add_minimum(Baz => '3.1416');
$new_prereq
->requirements_for(qw(build recommends))
->add_minimum(Bar => '3.000');
my $expect = {
runtime => { requires => { Foo => '1.000', Bar => '2.976' } },
test => { requires => { Baz => '3.1416' } },
build => { recommends => { Bar => '3.000' } },
};
is_deeply(
$new_prereq->as_string_hash,
$expect,
'we can accumulate new requirements on a prereq object',
);
my $merged_requires = {
Foo => '1.000',
Bar => '2.976',
Baz => '3.1416',
};
my $merged_all = {
Foo => '1.000',
Bar => '3.000',
Baz => '3.1416',
};
is_deeply(
$new_prereq->merged_requirements(
[qw/runtime test build/], [qw/requires/]
)->as_string_hash,
$merged_requires,
"we can merge requirements for phases/types"
);
is_deeply(
$new_prereq->merged_requirements->as_string_hash,
$merged_all,
"default merging is runtime/build/test for requires/recommends"
);
}
done_testing;
# vim: ts=2 sts=2 sw=2 et :
t/repository.t 0000644 00000010615 15170246504 0007422 0 ustar 00 use strict;
use warnings;
use Test::More 0.88;
use CPAN::Meta;
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_DECODER};
# 1.4 repository upgrade
{
my $label = "(version 1.4) old repository winds up in 'url'";
my $meta = CPAN::Meta->new(
{
name => 'Module-Billed',
abstract => 'inscrutable',
version => '1',
author => 'Joe',
release_status => 'stable',
license => 'perl_5',
dynamic_config => 1,
generated_by => 'hand',
'meta-spec' => {
version => '1.4',
url => 'http://module-build.sourceforge.net/META-spec-v1.4.html',
},
resources => {
repository => 'http://example.com/',
},
},
{ lazy_validation => 1 },
);
is_deeply(
$meta->resources,
{
repository => {
url => 'http://example.com/',
},
},
$label,
);
}
{
my $label = "(version 2 ) http in web passed through unchanged";
my $meta = CPAN::Meta->new(
{
name => 'Module-Billed',
abstract => 'inscrutable',
version => '1',
author => 'Joe',
release_status => 'stable',
license => 'perl_5',
dynamic_config => 1,
generated_by => 'hand',
'meta-spec' => {
version => '2',
},
resources => {
repository => {
web => 'http://example.com/',
},
},
},
{ lazy_validation => 1 },
);
is_deeply(
$meta->{resources},
{
repository => {
web => 'http://example.com/',
},
},
$label
);
}
{
my $label = "(version 2 ) http in url passed through unchanged";
my $meta = CPAN::Meta->new(
{
name => 'Module-Billed',
abstract => 'inscrutable',
version => '1',
author => 'Joe',
release_status => 'stable',
license => 'perl_5',
dynamic_config => 1,
generated_by => 'hand',
'meta-spec' => {
version => '2',
},
resources => {
repository => {
url => 'http://example.com/',
},
},
},
{ lazy_validation => 1 },
);
is_deeply(
$meta->{resources},
{
repository => {
url => 'http://example.com/',
},
},
$label
);
}
{
my $label = "(version 2 ) svn in url adds svn type";
my $meta = CPAN::Meta->new(
{
name => 'Module-Billed',
abstract => 'inscrutable',
version => '1',
author => 'Joe',
release_status => 'stable',
license => 'perl_5',
dynamic_config => 1,
generated_by => 'hand',
'meta-spec' => {
version => '2',
},
resources => {
repository => {
url => 'svn://example.com/',
},
},
},
{ lazy_validation => 1 },
);
is_deeply(
$meta->{resources},
{
repository => {
url => 'svn://example.com/',
type => 'svn',
},
},
$label
);
}
{
my $label = "(version 2 ) git in url adds svn type";
my $meta = CPAN::Meta->new(
{
name => 'Module-Billed',
abstract => 'inscrutable',
version => '1',
author => 'Joe',
release_status => 'stable',
license => 'perl_5',
dynamic_config => 1,
generated_by => 'hand',
'meta-spec' => {
version => '2',
},
resources => {
repository => {
url => 'git://example.com/',
},
},
},
{ lazy_validation => 1 },
);
is_deeply(
$meta->{resources},
{
repository => {
url => 'git://example.com/',
type => 'git',
},
},
$label
);
}
{
my $label = "(version 2 ) pre-existing type preserved";
my $meta = CPAN::Meta->new(
{
name => 'Module-Billed',
abstract => 'inscrutable',
version => '1',
author => 'Joe',
release_status => 'stable',
license => 'perl_5',
dynamic_config => 1,
generated_by => 'hand',
'meta-spec' => {
version => '2',
},
resources => {
repository => {
url => 'git://example.com/',
type => 'msysgit',
},
},
},
{ lazy_validation => 1 },
);
is_deeply(
$meta->{resources},
{
repository => {
url => 'git://example.com/',
type => 'msysgit',
},
},
$label
);
}
done_testing;
# vim: ts=2 sts=2 sw=2 et :
t/save-load.t 0000644 00000007254 15170246504 0007063 0 ustar 00 use strict;
use warnings;
use Test::More 0.88;
use CPAN::Meta;
use File::Temp 0.20 ();
use Parse::CPAN::Meta;
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_DECODER};
my $distmeta = {
name => 'Module-Build',
abstract => 'Build and install Perl modules',
description => "Module::Build is a system for building, testing, "
. "and installing Perl modules. It is meant to be an "
. "alternative to ExtUtils::MakeMaker... blah blah blah",
version => '0.36',
author => [
'Ken Williams <kwilliams@cpan.org>',
'Module-Build List <module-build@perl.org>', # additional contact
],
release_status => 'stable',
license => [ 'perl_5' ],
prereqs => {
runtime => {
requires => {
'perl' => '5.006',
'Config' => '0',
'Cwd' => '0',
'Data::Dumper' => '0',
'ExtUtils::Install' => '0',
'File::Basename' => '0',
'File::Compare' => '0',
'File::Copy' => '0',
'File::Find' => '0',
'File::Path' => '0',
'File::Spec' => '0',
'IO::File' => '0',
},
recommends => {
'Archive::Tar' => '1.00',
'ExtUtils::Install' => '0.3',
'ExtUtils::ParseXS' => '2.02',
'Pod::Text' => '0',
'YAML' => '0.35',
},
},
build => {
requires => {
'Test::More' => '0',
},
}
},
resources => {
license => ['http://dev.perl.org/licenses/'],
},
optional_features => {
domination => {
description => 'Take over the world',
prereqs => {
develop => { requires => { 'Genius::Evil' => '1.234' } },
runtime => { requires => { 'Machine::Weather' => '2.0' } },
},
},
},
dynamic_config => 1,
keywords => [ qw/ toolchain cpan dual-life / ],
'meta-spec' => {
version => '2',
url => 'http://search.cpan.org/perldoc?CPAN::Meta::Spec',
},
generated_by => 'Module::Build version 0.36',
};
my $meta = CPAN::Meta->new( $distmeta );
my $tmpdir = File::Temp->newdir();
my $metafile = File::Spec->catfile( $tmpdir, 'META.json' );
ok( $meta->save($metafile), "save returns true" );
ok( -f $metafile, "save meta to file" );
ok( my $loaded = Parse::CPAN::Meta->load_file($metafile), 'load saved file' );
is($loaded->{name}, 'Module-Build', 'name correct');
like(
$loaded->{x_serialization_backend},
qr/\AJSON::PP version [0-9]/,
"x_serialization_backend",
);
ok(
! exists $meta->{x_serialization_backend},
"we didn't leak x_serialization_backend up into the saved struct",
);
ok( $loaded = Parse::CPAN::Meta->load_file('t/data-test/META-1_4.yml'), 'load META-1.4' );
is($loaded->{name}, 'Module-Build', 'name correct');
# Test saving with conversion
my $metayml = File::Spec->catfile( $tmpdir, 'META.yml' );
$meta->save($metayml, {version => "1.4"});
ok( -f $metayml, "save meta to META.yml with conversion" );
ok( $loaded = Parse::CPAN::Meta->load_file($metayml), 'load saved file' );
is( $loaded->{name}, 'Module-Build', 'name correct');
is( $loaded->{requires}{perl}, "5.006", 'prereq correct' );
like(
$loaded->{x_serialization_backend},
qr/\ACPAN::Meta::YAML version [0-9]/,
"x_serialization_backend",
);
ok(
! exists $meta->{x_serialization_backend},
"we didn't leak x_serialization_backend up into the saved struct",
);
# file without suffix
ok( $loaded = CPAN::Meta->load_file('t/data-test/META-2.meta'), 'load_file META-2.meta' );
my $string = do { open my $fh, '<', 't/data-test/META-2.meta'; local $/; <$fh> };
ok( $loaded = CPAN::Meta->load_string($string), 'load META-2.meta from string' );
done_testing;
# vim: ts=2 sts=2 sw=2 et :
t/validator.t 0000644 00000002320 15170246504 0007162 0 ustar 00 use strict;
use warnings;
use Test::More 0.88;
use CPAN::Meta;
use CPAN::Meta::Validator;
use File::Spec;
use IO::Dir;
use Parse::CPAN::Meta;
delete $ENV{PERL_YAML_BACKEND};
delete $ENV{PERL_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_BACKEND};
delete $ENV{CPAN_META_JSON_DECODER};
{
my @data_dirs = qw( t/data-test t/data-valid );
my @files = sort map {
my $d = $_;
map { "$d/$_" } grep { substr($_,0,1) ne '.' } IO::Dir->new($d)->read
} @data_dirs;
for my $f ( @files ) {
my $meta = Parse::CPAN::Meta->load_file( File::Spec->catfile($f) );
my $cmv = CPAN::Meta::Validator->new({%$meta});
ok( $cmv->is_valid, "$f validates" )
or diag( "ERRORS:\n" . join( "\n", $cmv->errors ) );
}
}
{
my @data_dirs = qw( t/data-fail t/data-fixable );
my @files = sort map {
my $d = $_;
map { "$d/$_" } grep { substr($_,0,1) ne '.' } IO::Dir->new($d)->read
} @data_dirs;
for my $f ( @files ) {
my $meta = Parse::CPAN::Meta->load_file( File::Spec->catfile($f) );
my $cmv = CPAN::Meta::Validator->new({%$meta});
ok( ! $cmv->is_valid, "$f shouldn't validate" );
note 'validation error: ', $_ foreach $cmv->errors;
}
}
done_testing;
# vim: ts=2 sts=2 sw=2 et :
CONTRIBUTING.mkdn 0000644 00000005751 15170246504 0007342 0 ustar 00 ## HOW TO CONTRIBUTE
Thank you for considering contributing to this distribution. This file
contains instructions that will help you work with the source code.
The distribution is managed with Dist::Zilla. This means than many of the
usual files you might expect are not in the repository, but are generated at
release time, as is much of the documentation. Some generated files are
kept in the repository as a convenience (e.g. Makefile.PL or cpanfile).
Generally, **you do not need Dist::Zilla to contribute patches**. You do need
Dist::Zilla to create a tarball. See below for guidance.
### Getting dependencies
If you have App::cpanminus 1.6 or later installed, you can use `cpanm` to
satisfy dependencies like this:
$ cpanm --installdeps .
Otherwise, look for either a `Makefile.PL` or `cpanfile` file for
a list of dependencies to satisfy.
### Running tests
You can run tests directly using the `prove` tool:
$ prove -l
$ prove -lv t/some_test_file.t
For most of my distributions, `prove` is entirely sufficient for you to test any
patches you have. I use `prove` for 99% of my testing during development.
### Code style and tidying
Please try to match any existing coding style. If there is a `.perltidyrc`
file, please install Perl::Tidy and use perltidy before submitting patches.
If there is a `tidyall.ini` file, you can also install Code::TidyAll and run
`tidyall` on a file or `tidyall -a` to tidy all files.
### Patching documentation
Much of the documentation Pod is generated at release time. Some is
generated boilerplate; other documentation is built from pseudo-POD
directives in the source like C<=method> or C<=func>.
If you would like to submit a documentation edit, please limit yourself to
the documentation you see.
If you see typos or documentation issues in the generated docs, please
email or open a bug ticket instead of patching.
### Installing and using Dist::Zilla
Dist::Zilla is a very powerful authoring tool, optimized for maintaining a
large number of distributions with a high degree of automation, but it has a
large dependency chain, a bit of a learning curve and requires a number of
author-specific plugins.
To install it from CPAN, I recommend one of the following approaches for
the quickest installation:
# using CPAN.pm, but bypassing non-functional pod tests
$ cpan TAP::Harness::Restricted
$ PERL_MM_USE_DEFAULT=1 HARNESS_CLASS=TAP::Harness::Restricted cpan Dist::Zilla
# using cpanm, bypassing *all* tests
$ cpanm -n Dist::Zilla
In either case, it's probably going to take about 10 minutes. Go for a walk,
go get a cup of your favorite beverage, take a bathroom break, or whatever.
When you get back, Dist::Zilla should be ready for you.
Then you need to install any plugins specific to this distribution:
$ cpan `dzil authordeps`
$ dzil authordeps | cpanm
Once installed, here are some dzil commands you might try:
$ dzil build
$ dzil test
$ dzil xtest
You can learn more about Dist::Zilla at http://dzil.org/
Changes 0000644 00000040571 15170246504 0006052 0 ustar 00 Revision history for CPAN-Meta
2.150010 2016-08-18 12:10:08-04:00 America/New_York
[FIXED]
- the YAML and JSON backend variables are ignored when building/testing the
perl core itself, where non-core backends are not yet installed.
[CHANGED]
- Added "use warnings" to Parse::CPAN::Meta
2.150009 2016-07-02 21:07:49-04:00 America/New_York (TRIAL RELEASE)
[FIXED]
- Fixed used of Encode in Parse::CPAN::Meta::load_json_string
(Cherry picked from Parse::CPAN::Meta 1.4422)
2.150008 2016-06-28 17:01:03-04:00 America/New_York (TRIAL RELEASE)
[ADDED]
- Merged Parse::CPAN::Meta 1.4420 into this distribution
2.150007 2016-06-28 03:48:16-04:00 America/New_York (TRIAL RELEASE)
[FIXED]
- The cloning routine would raise an error on expected types when it
previously would stringify. The old behavior is restored.
2.150006 2016-06-23 20:05:46-04:00 America/New_York (TRIAL RELEASE)
[FIXED]
- CPAN::Meta::Prereqs now fully accepts phases and types starting with 'x_'.
New 'phases' and 'types_in' interfaces have been added.
- No longer relies on JSON backend for data structure cloning. This is
much faster than using JSON::PP.
[TESTS]
- The 'extra_mappings' feature for meta merging is now tested and
documented.
- During tests, delete new environment variables added by
Parse::CPAN::Meta 1.4418
[SPEC]
- Clarifies acceptable values for booleans
- Cleaned up text and links of historical specs.
2.150005 2015-06-09 19:08:44-06:00 America/Denver
[TESTING]
- Changed some test data from UTF-8 to ASCII
2.150004 2015-05-19 11:25:53-04:00 America/New_York (TRIAL RELEASE)
[DOCUMENTED]
- Noted explicitly that historical META spec files are licensed under
the same terms as Perl
[TESTING]
- Added test for 'x_deprecated' field in "provides"
[META]
- declared extra developer prereq
2.150003 2015-04-21 19:41:15-04:00 America/New_York (TRIAL RELEASE)
[CHANGED]
- Serialized CPAN::Meta objects now include a x_serialization_backend
entry
2.150002 2015-04-19 01:00:10+02:00 Europe/Berlin (TRIAL RELEASE)
[CHANGED]
- Metadata merging now does deep hash merging as long as keys
don't conflict
2.150001 2015-03-09 14:41:39-04:00 America/New_York
[DOCUMENTED]
- Include allowed values for license field in 1.x historic licenses rather
than linking to Module::Build
- Documented when fragment merging became available
2.143240 2014-11-20 10:26:30-05:00 America/New_York
[FIXED]
- Give correct path in nested merges such as resources
- Removed strings test that should have been removed when
CPAN::Meta::Requirements was removed to a separate dist
2.142690 2014-09-26 11:06:34-04:00 America/New_York
[FIXED]
- Fixed use of incorrect method in CPAN::Meta::Merge implementation
[DOCUMENTED]
- Clarified that no_index is a list of exclusions, and that indexers
should generally exclude 'inc', 'xt' and 't' as well.
- CPAN::Meta::History::Meta_1_0 through 1_4 are added as a permanent
record of 1.x versions of the metaspec
2.142060 2014-07-25 13:30:06-04:00 America/New_York
[ADDED]
- CPAN::Meta::Merge is a new class for merging two possibly overlapping
instances of metadata. It will accept both CPAN::Meta objects and
(possibly incomplete) hashrefs of metadata.
2.141520 2014-05-31 23:41:13-04:00 America/New_York
[DOCUMENTED]
- Clarified use of 'file' for the 'provides' field in the Spec
2.141170 2014-04-27 13:03:37-04:00 America/New_York
[ADDED]
- Added ability for CPAN::Meta::Converter to convert metadata fragments
(incomplete portions of a metadata structure)
[CHANGED]
- Optimized internal use of JSON for datastructure cloning
[FIXED]
- Removed dependency on List::Util 1.33
[DOCUMENTED]
- Clarified language around 'dynamic_config' in the Spec
2.140640 2014-03-05 09:07:05-05:00 America/New_York
[FIXED]
- A change to the default meta-spec URL in 2.140630 from search.cpan.org
to metacpan.org broke Module::Build and ExtUtils::MakeMaker. This
reverts that change. Also added the missing change note to the prior
version.
2.140630 2014-03-04 15:23:40-05:00 America/New_York
[CHANGED]
- Default meta-spec URL points to metacpan.org instead of search.cpan.org
[ADDED]
- Added a 'load_string' method that guesses whether the string
is YAML or JSON
2.133380 2013-12-03 23:01:07 America/New_York
[FIXED]
- Improved bad version handling during META conversion
- When downgrading multiple licenses to version 1.x META formats, if all
the licenses are open source, the downgraded license will be
"open_source", not "unknown"
2.132830 2013-10-10 16:04:30 America/New_York
[ADDED]
- CPAN::Meta::Prereqs now has a 'merged_requirements' method for
combining requirements across multiple phases and types
[FIXED]
- Invalid 'meta-spec' is no longer a fatal error: instead, it will
usually be treated as spec version "1.0" (prior to formalization of the
meta-spec field). Conversion has some heuristics for guessing a
version depending on other fields if 'meta-spec' is missing or invalid.
2.132661 2013-09-23 13:27:46 America/New_York
[FIXED]
- updated Makefile.PL logic to support PERL_NO_HIGHLANDER
[PREREQS]
- Dropped ExtUtils::MakeMaker configure_requires dependency
to 6.17
2.132660 2013-09-23 06:04:04 America/New_York
[FIXED]
- Installation on Perls < 5.12 will uninstall older versions installed
due to being bundled with ExtUtils::MakeMaker
2.132620 2013-09-19 11:18:33 America/New_York
[CHANGED]
- META validation used to allow a scalar value when a list (i.e. array
reference) was required for a field. This has been tightened and
validation will now fail if a scalar value is given. Conversion will
continue to turn scalars into an array reference as it previously did.
2.132510 2013-09-08 10:17:29 America/New_York
[FIXED]
- Fixed incorrectly encoded META.yml
2.132140 2013-08-02 11:54:17 America/New_York
[DOCUMENTATION]
- Fixed some typos in CPAN::Meta::Spec
[OTHER]
- migrated repository to Perl-Toolchain-Gang organization on Github and
updated metadata accordingly
2.131560 2013-06-05 15:26:36 America/New_York
[DOCUMENTATION]
- Replaced CPAN::Meta SYNOPSIS with code that actually works
2.131490 2013-05-29 14:15:16 America/New_York
[BUGFIX]
- Downconversion of custom resources was not dropping the leading "x_".
Now "x_MailingList" will downconvert correctly to "MailingList".
[SPEC]
- Per the Lancaster Consensus, the 'file' subkey of a package listed in
'provides' must refer to an actual file in the distribution, either the
.pm file that provides the package or another file (*.PL) that
generates it
2.130880 2013-03-29 09:51:00 America/New_York
[BUGFIX]
- Fix provides 'version' bug introduced in the 2.130870 fix
2.130870 2013-03-28 11:08:50 America/New_York
[BUGFIX]
- Don't add 'version' to 'provides' during conversion if one didn't
exist in the original [Reported by Miyagawa; fixed by David Golden]
2.120921 2012-04-01 15:20:24 Europe/Paris
[REMOVED]
- CPAN::Meta::Requirements has been split out into its own distribution
so it can be used by CPAN.pm without requiring all of CPAN::Meta
2.120920 2012-04-01 11:30:43 Europe/Paris
[ADDED]
- CPAN::Meta::Requirements now has a 'requirements_for_module' method
to retrieve a version requirements string for a specific module
[Leon Timmermans]
[OTHER]
- Parse::CPAN::Meta prerequisite bumped to 1.4403
- JSON::PP prerequisites bumped to 2.27200
- CPAN::Meta::YAML prerequisite bumped to 0.008
2.120900 2012-03-30 13:15:15 Europe/Paris
[BUGFIX]
- CPAN::Meta::Requirements now treats undef requirements given to
from_string_hash() as '0' and warns about it; add_string_requirements()
dies if it does not get a requirements string to parse
2.120630 2012-03-03 14:48:35 EST5EDT
[BUGFIX]
- CPAN::Meta::Requirements now ensures that dotted-decimal versions are
represented in normalized form when stringified. This fixes a
regression in META conversion in 2.120620.
[Reported by Kent Fredric; fixed by David Golden]
2.120620 2012-03-02 12:28:59 EST5EDT
[ADDED]
- CPAN::Meta::Requirements::add_string_requirements allows building
a requirements specification piecemeal [Cory G. Watson]
[BUGFIX]
- Version range handling fixed [rt.cpan.org #75424]
- CPAN::Meta::Converter handles bad version strings more gracefully,
truncating alphanumerics and otherwise falling back to "0". This
is likely better than dropping a prerequisite or dying.
[rt.cpan.org #75427]
2.120530 2012-02-22 16:15:31 EST5EDT
[OTHER]
- Dialed back perl prereq to 5.006
2.120351 2012-02-03 23:01:45 America/New_York
[OTHER]
- Fixed CPAN packaging errors
2.120350 2012-02-03 22:46:59 America/New_York
[BUGFIX]
- Work around a memory leak bug involving version objects
in boolean context.
2.113640 2011-12-30 15:19:46 America/New_York
[OTHER]
- Version::Requirements has now been merged as CPAN::Meta::Requirements,
rendering Version::Requirements itself redundant
2.112621 2011-09-19 12:15:16 America/New_York
[BUGFIX]
- Spell BACKEND environment variables correctly this time
[noticed by Stevan Little]
2.112620 2011-09-18 20:56:06 America/New_York
[BUGFIX]
- Protect tests against PERL_(YAML|JSON)_BACKEND settings that could
cause tests to fail. (RT #69979)
2.112600 2011-09-17 12:21:09 America/New_York
[DOCUMENTATION]
- Fixed spelling error in CPAN::Meta::Spec (RT #71036) [Gregor Hermann]
2.112580 2011-09-15 10:53:59 America/New_York
[BUGFIX]
- Use UTF-8 mode for internal structure cloning to avoid bugs
in Perl <= 5.8.6 (RT #70936) [Dagfinn Ilmari Mannsåker]
2.112150 2011-08-02 22:25:41 America/New_York
[BUGFIX]
- Stringify any objects encountered during conversion. (RT #67295)
- Fixed some broken URLs in documentation and for LGPL in legacy
conversion (RT #68738)
- Fixed invalid private Pod in CPAN::Meta::Validator (RT #65925)
[SPEC]
- Clarified that file paths in the 'provides' section must be in
Unix-style (i.e. forward slashes) (RT #69045)
- Replaced examples using Module::Build::ModuleInfo with Module::Metadata
(RT #66135)
2.110930 2011-04-02 23:31:24 America/New_York
[BUGFIX]
- Fixed a bug in the 'as_string' method that checked the module version
instead of the meta-spec version when conversion was requested
(RT #67188)
2.110910 2011-04-01 08:55:30 America/New_York
[ENHANCEMENTS]
- The 1.x spec "gpl" and "lgpl" and "mozilla" license values now up-convert
to "open_source" because they indicate too non-specific a license.
2.110580 2011-02-27 07:58:06 EST5EDT
[OTHER]
- Add explicit dependencies on JSON::PP and CPAN::Meta::YAML instead
of relying on Parse::CPAN::Meta to provide them (as some CPAN Testers
have had P::C::M installed without them somehow)
- Removed dependency on Storable as it was not a core module
until Perl 5.8
2.110550 2011-02-24 07:17:57 EST5EDT
[OTHER]
- Added required field 'release_status' to the synopsis of
CPAN::Meta::Spec (RT#66118) [Oliver Mengué]
2.110540 2011-02-23 15:21:16 EST5EDT
[BUGFIX]
- Had two different Parse::CPAN::Meta requirements, one in 'requires' and
the other in 'build_requires'. This confused some installers, so we
only inlude the 'requires' now.
2.110440 2011-02-12 22:55:28 EST5EDT
[BUGFIX]
- Bump Parse::CPAN::Meta prereq to 1.44, as 1.43 was never released
2.110420 2011-02-11 15:40:36 EST5EDT
[BUG FIXES]
- The as_string() method now always returns a character string;
previously, JSON strings were UTF-8 encoded.
- The save() method now always saves with UTF-8 encoding for
Perl 5.8.1 or greater; previously, YAML was not encoded
2.110390 2011-02-07 21:00:47 EST5EDT
[BUG FIXES]
- Release 2.110360 had a regression where the save() method would no
longer return true on success. That has been fixed.
2.110360 2011-02-04 19:46:21 America/New_York
[OTHER]
- Remove autodie dependency so CPAN::Meta can be used on older Perls
- Remove unused Data::Dumper dependency
2.110350 2011-02-03 19:57:32 America/New_York
[ENHANCEMENTS]
- Added "as_string" method similar to "as_struct"
[OTHER]
- Bumped Parse::CPAN::Meta prereq to 1.43 and uses that to
determine proper YAML/JSON backends
- Removed unused prereqs
2.110330 2011-02-02 09:42:57 EST5EDT
[ENHANCEMENTS]
- Saved META.json files are now sorted by key
- as_struct() method takes an optional "version" argument to return
a down-converted metadata hashref
2.110320 2011-01-31 23:14:30 EST5EDT
[ENHANCEMENTS]
- The 'save' method now allows an optional hashref argument, which can be
used to set the desired meta spec version. Metadata is automatically
converted to the specified output.
2.110240 2011-01-24 16:28:25 EST5EDT
- Reading JSON/YAML is delegated entirely to Parse::CPAN::Meta (1.4200)
- JSON.pm is dropped as a prerequisite and JSON::PP is added to prepare
for CPAN::Meta to be added to the Perl core
- JSON writing uses the same JSON backend selection as Parse::CPAN::Meta
to allow "upgrading" to a non-core JSON backend module if desired
2.102400 2010-08-28 14:06:34 America/New_York
- 'as_struct' method now returns unblessed data (reported by Chris Prather)
2.102160 2010-08-04 12:27:10 EST5EDT
- Fix bugtracker conversion bug (RT#60017)
2.101670 2010-06-15 21:02:42 EST5EDT
- converting 1.x 'repository' field now puts converted url into the
'url' sub-field of 'repository' instead of the 'web' sub-field
2.101610 2010-06-10 18:51:30 EST5EDT
- fixed converter bug that output 'artistic2' instead of 'artistic_2'
for license in 1.X specs
- 'artistic2' is now converted to 'artistic_2' if it occurs
- corrected validation for 'artistic_2' and disallowed 'artistic-2.0'
2.101600 2010-06-09 10:07:31 EST5EDT
- improve conversion of restricted/restrictive license keys between
spec versions 1.4 and 2 [reported by Alexander Hartmaier]
2.101591 2010-06-08 09:56:17 EST5EDT
- added 'as_struct' method to CPAN::Meta to get a deep copy of
the metadata hash_ref
- won't add an optional_features 'description' field if missing
- improved documentation of CPAN::Meta::Converter and how it deals
with bad/missing data
2.101590 2010-06-07 21:49:36 EST5EDT
- won't automatically add 'unknown' as repository type when converting;
instead, will only add a repository type if a repository 'url' is
present and it is of the 'svn:' or 'git:' scheme.
- squelched some uninitialized value warnings [Graham Barr]
2.101580 2010-06-07 16:44:13 EST5EDT
- add "lazy_validation" option to constructors
- add ability to "convert" to same version and clean-up any fixable
errors
- fix validation bugs (adhere closer to the spec)
- improve lots of heuristics during conversion
2.101461 2010-05-26 16:57:02 America/New_York
- accessors deep clone list and map keys before returning them
- add custom_keys() and custom() methods
2.101460 2010-05-25 23:12:27 America/New_York
- loosen URL validation -- only a scheme and authority are required
without restrictions on either
2.101450 2010-05-25 17:59:32 America/New_York
- when downconverting from 2, leave custom keys unchanged
(except in resources, where x_ is changed to X_)
- when converting to 2, don't prepend x_ to custom keys that already
matched qr{\Ax_}i
2.101410 2010-05-21 10:39:18 EST5EDT
- when downconverting from 2, merge test requirements into build requirements
2.101390 2010-05-19 10:49:50 EST5EDT
- do not clobber generated_by when converting
2.101380 2010-05-17 23:39:23 EST5EDT
- added support for down-converting to older versions of the spec
- improved test coverage for conversion and validation
2.101110 2010-04-21 11:06:52 EST5EDT
- clarified that .XXXXXX versions of the CPAN-Meta distribution will not
change the meaning of the CPAN::Meta::Spec, but may fix typos or
clarify prose
- fixed a typo regarding dotted-integer versions: keeping components
in the range 0-999 was corrected to a "should" instead of a "must"
- fixed validation bugs for certain types of nested data structures
(based on a patch provided by Barbie)
2.101091 2010-04-19 06:32:13 EST5EDT
- keep the old specs from getting indexed so as not to confuse people
# vim: ts=2 sts=2 sw=2 et:
README 0000644 00000027220 15170246504 0005433 0 ustar 00 NAME
CPAN::Meta - the distribution metadata for a CPAN dist
VERSION
version 2.150010
SYNOPSIS
use v5.10;
use strict;
use warnings;
use CPAN::Meta;
use Module::Load;
my $meta = CPAN::Meta->load_file('META.json');
printf "testing requirements for %s version %s\n",
$meta->name,
$meta->version;
my $prereqs = $meta->effective_prereqs;
for my $phase ( qw/configure runtime build test/ ) {
say "Requirements for $phase:";
my $reqs = $prereqs->requirements_for($phase, "requires");
for my $module ( sort $reqs->required_modules ) {
my $status;
if ( eval { load $module unless $module eq 'perl'; 1 } ) {
my $version = $module eq 'perl' ? $] : $module->VERSION;
$status = $reqs->accepts_module($module, $version)
? "$version ok" : "$version not ok";
} else {
$status = "missing"
};
say " $module ($status)";
}
}
DESCRIPTION
Software distributions released to the CPAN include a META.json or, for
older distributions, META.yml, which describes the distribution, its
contents, and the requirements for building and installing the
distribution. The data structure stored in the META.json file is
described in CPAN::Meta::Spec.
CPAN::Meta provides a simple class to represent this distribution
metadata (or *distmeta*), along with some helpful methods for
interrogating that data.
The documentation below is only for the methods of the CPAN::Meta
object. For information on the meaning of individual fields, consult the
spec.
METHODS
new
my $meta = CPAN::Meta->new($distmeta_struct, \%options);
Returns a valid CPAN::Meta object or dies if the supplied metadata hash
reference fails to validate. Older-format metadata will be up-converted
to version 2 if they validate against the original stated specification.
It takes an optional hashref of options. Valid options include:
* lazy_validation -- if true, new will attempt to convert the given
metadata to version 2 before attempting to validate it. This means
than any fixable errors will be handled by CPAN::Meta::Converter
before validation. (Note that this might result in invalid optional
data being silently dropped.) The default is false.
create
my $meta = CPAN::Meta->create($distmeta_struct, \%options);
This is same as "new()", except that "generated_by" and "meta-spec"
fields will be generated if not provided. This means the metadata
structure is assumed to otherwise follow the latest CPAN::Meta::Spec.
load_file
my $meta = CPAN::Meta->load_file($distmeta_file, \%options);
Given a pathname to a file containing metadata, this deserializes the
file according to its file suffix and constructs a new "CPAN::Meta"
object, just like "new()". It will die if the deserialized version fails
to validate against its stated specification version.
It takes the same options as "new()" but "lazy_validation" defaults to
true.
load_yaml_string
my $meta = CPAN::Meta->load_yaml_string($yaml, \%options);
This method returns a new CPAN::Meta object using the first document in
the given YAML string. In other respects it is identical to
"load_file()".
load_json_string
my $meta = CPAN::Meta->load_json_string($json, \%options);
This method returns a new CPAN::Meta object using the structure
represented by the given JSON string. In other respects it is identical
to "load_file()".
load_string
my $meta = CPAN::Meta->load_string($string, \%options);
If you don't know if a string contains YAML or JSON, this method will
use Parse::CPAN::Meta to guess. In other respects it is identical to
"load_file()".
save
$meta->save($distmeta_file, \%options);
Serializes the object as JSON and writes it to the given file. The only
valid option is "version", which defaults to '2'. On Perl 5.8.1 or
later, the file is saved with UTF-8 encoding.
For "version" 2 (or higher), the filename should end in '.json'.
JSON::PP is the default JSON backend. Using another JSON backend
requires JSON 2.5 or later and you must set the $ENV{PERL_JSON_BACKEND}
to a supported alternate backend like JSON::XS.
For "version" less than 2, the filename should end in '.yml'.
CPAN::Meta::Converter is used to generate an older metadata structure,
which is serialized to YAML. CPAN::Meta::YAML is the default YAML
backend. You may set the $ENV{PERL_YAML_BACKEND} to a supported
alternative backend, though this is not recommended due to subtle
incompatibilities between YAML parsers on CPAN.
meta_spec_version
This method returns the version part of the "meta_spec" entry in the
distmeta structure. It is equivalent to:
$meta->meta_spec->{version};
effective_prereqs
my $prereqs = $meta->effective_prereqs;
my $prereqs = $meta->effective_prereqs( \@feature_identifiers );
This method returns a CPAN::Meta::Prereqs object describing all the
prereqs for the distribution. If an arrayref of feature identifiers is
given, the prereqs for the identified features are merged together with
the distribution's core prereqs before the CPAN::Meta::Prereqs object is
returned.
should_index_file
... if $meta->should_index_file( $filename );
This method returns true if the given file should be indexed. It decides
this by checking the "file" and "directory" keys in the "no_index"
property of the distmeta structure. Note that neither the version format
nor "release_status" are considered.
$filename should be given in unix format.
should_index_package
... if $meta->should_index_package( $package );
This method returns true if the given package should be indexed. It
decides this by checking the "package" and "namespace" keys in the
"no_index" property of the distmeta structure. Note that neither the
version format nor "release_status" are considered.
features
my @feature_objects = $meta->features;
This method returns a list of CPAN::Meta::Feature objects, one for each
optional feature described by the distribution's metadata.
feature
my $feature_object = $meta->feature( $identifier );
This method returns a CPAN::Meta::Feature object for the optional
feature with the given identifier. If no feature with that identifier
exists, an exception will be raised.
as_struct
my $copy = $meta->as_struct( \%options );
This method returns a deep copy of the object's metadata as an unblessed
hash reference. It takes an optional hashref of options. If the hashref
contains a "version" argument, the copied metadata will be converted to
the version of the specification and returned. For example:
my $old_spec = $meta->as_struct( {version => "1.4"} );
as_string
my $string = $meta->as_string( \%options );
This method returns a serialized copy of the object's metadata as a
character string. (The strings are not UTF-8 encoded.) It takes an
optional hashref of options. If the hashref contains a "version"
argument, the copied metadata will be converted to the version of the
specification and returned. For example:
my $string = $meta->as_string( {version => "1.4"} );
For "version" greater than or equal to 2, the string will be serialized
as JSON. For "version" less than 2, the string will be serialized as
YAML. In both cases, the same rules are followed as in the "save()"
method for choosing a serialization backend.
The serialized structure will include a "x_serialization_backend" entry
giving the package and version used to serialize. Any existing key in
the given $meta object will be clobbered.
STRING DATA
The following methods return a single value, which is the value for the
corresponding entry in the distmeta structure. Values should be either
undef or strings.
* abstract
* description
* dynamic_config
* generated_by
* name
* release_status
* version
LIST DATA
These methods return lists of string values, which might be represented
in the distmeta structure as arrayrefs or scalars:
* authors
* keywords
* licenses
The "authors" and "licenses" methods may also be called as "author" and
"license", respectively, to match the field name in the distmeta
structure.
MAP DATA
These readers return hashrefs of arbitrary unblessed data structures,
each described more fully in the specification:
* meta_spec
* resources
* provides
* no_index
* prereqs
* optional_features
CUSTOM DATA
A list of custom keys are available from the "custom_keys" method and
particular keys may be retrieved with the "custom" method.
say $meta->custom($_) for $meta->custom_keys;
If a custom key refers to a data structure, a deep clone is returned.
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.
SEE ALSO
* CPAN::Meta::Converter
* CPAN::Meta::Validator
SUPPORT
Bugs / Feature Requests
Please report any bugs or feature requests through the issue tracker at
<https://github.com/Perl-Toolchain-Gang/CPAN-Meta/issues>. You will be
notified automatically of any progress on your issue.
Source Code
This is open source software. The code repository is available for
public review and contribution under the terms of the license.
<https://github.com/Perl-Toolchain-Gang/CPAN-Meta>
git clone https://github.com/Perl-Toolchain-Gang/CPAN-Meta.git
AUTHORS
* David Golden <dagolden@cpan.org>
* Ricardo Signes <rjbs@cpan.org>
* Adam Kennedy <adamk@cpan.org>
CONTRIBUTORS
* Ansgar Burchardt <ansgar@cpan.org>
* Avar Arnfjord Bjarmason <avar@cpan.org>
* Benjamin Noggle <agwind@users.noreply.github.com>
* Christopher J. Madsen <cjm@cpan.org>
* Chuck Adams <cja987@gmail.com>
* Cory G Watson <gphat@cpan.org>
* Damyan Ivanov <dam@cpan.org>
* David Golden <xdg@xdg.me>
* Eric Wilhelm <ewilhelm@cpan.org>
* Graham Knop <haarg@haarg.org>
* Gregor Hermann <gregoa@debian.org>
* Karen Etheridge <ether@cpan.org>
* Kenichi Ishigaki <ishigaki@cpan.org>
* Kent Fredric <kentfredric@gmail.com>
* Ken Williams <kwilliams@cpan.org>
* Lars Dieckow <daxim@cpan.org>
* Leon Timmermans <leont@cpan.org>
* majensen <maj@fortinbras.us>
* Mark Fowler <markf@cpan.org>
* Matt S Trout <mst@shadowcat.co.uk>
* Michael G. Schwern <mschwern@cpan.org>
* Mohammad S Anwar <mohammad.anwar@yahoo.com>
* mohawk2 <mohawk2@users.noreply.github.com>
* moznion <moznion@gmail.com>
* Niko Tyni <ntyni@debian.org>
* Olaf Alders <olaf@wundersolutions.com>
* Olivier Mengué <dolmen@cpan.org>
* Randy Sims <randys@thepierianspring.org>
* Tomohiro Hosaka <bokutin@bokut.in>
COPYRIGHT AND LICENSE
This software is copyright (c) 2010 by David Golden, Ricardo Signes,
Adam Kennedy and Contributors.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
Todo 0000644 00000000415 15170246504 0005400 0 ustar 00 improve validation/conversion testing of valid/invalid specs
move the distmeta struct to $self->{distmeta} or something rather than having
it be the entire gits of the CPAN::Meta
validate version numbers with version::is_lax
use dclone more in converting structures