/ 
CPAN-Meta-2.101590
River stage five • 443 direct dependents • 19560 total dependents
/ CPAN::Meta::Converter

NAME

CPAN::Meta::Converter - Convert CPAN distribution metadata structures

VERSION

version 2.101590

SYNOPSIS

my $struct = decode_json_file('META.json');

my $cmc = CPAN::Meta::Converter->new( $struct );

my $new_struct = $cmc->convert( version => "2" );

DESCRIPTION

This module converts CPAN Meta structures from one form to another. The primary use is to convert older structures to the most modern version of the specification, but other transformations may be implemented in the future as needed. (E.g. stripping all custom fields or stripping all optional fields.)

METHODS

new

my $cmc = CPAN::Meta::Converter->new( $struct );

The constructor should be passed a valid metadata structure but invalid structures are accepted. If no meta-spec version is provided, version 1.0 will be assumed.

convert

my $new_struct = $cmc->convert( version => "2" );

Returns a new hash reference with the metadata converted to a different form.

Valid parameters include:

  • version

    Indicates the desired specification version (e.g. "1.0", "1.1" ... "1.4", "2"). Defaults to the latest version of the CPAN Meta Spec.

The conversion process attempts to clean-up simple errors and standardize data during converstion. For example, if author is given as a scalar, it will converted to an array reference containing the item, or if a mandatory license field is missing, it will be added as "unknown".

Conversion proceeds through each version in turn. For example, a version 1.2 structure is converted to 1.3 then 1.4 then finally version 2. Converting a structure to its own version will still clean-up and standardize the structure.

convert will die if any conversion/standardization still results in an invalid structure.

BUGS

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

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

AUTHORS

David Golden <dagolden@cpan.org>
Ricardo Signes <rjbs@cpan.org>

COPYRIGHT AND LICENSE

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

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