NAME

Gentoo::Perl::Distmap - A reader/writer for the metadata/perl/distmap.json file.

VERSION

version 0.2.0

SYNOPSIS

my $dm  = Gentoo::Perl::Distmap->load(  file => '../path/to/distmap.json' );
$dm->save( file => '/tmp/foo.x' );

for my $dist ( sort $dm->dists_in_repository('gentoo') ) {
	/* see the upstream distnames visible in gentoo */
}
for my $dist ( sort $dm->dists_in_repository('perl-experimental') ) {
	/* see the upstream distnames visible in perl-experimental */
}
for my $dist ( sort $dm->multi_repository_dists ) {
	/* see the dists that exist in more than one repository */
}
-	for my $dist ( sort $dm->mapped_dists ) {
	/* see the dists that have at least one version in the dataset */
	/* note: dists with empty version sets should be deemed a bug  */
}

Interface for creating/augmenting/comparing .json files still to be defined, basic functionality only at this time.

ATTRIBUTES

map

METHODS

save

$instance->save( file => $filepath );
$instance->save( filehandle => $fh );
my $string = $instance->save( string => );

CLASS METHODS

load

my $instance = G:P:Distmap->load( file => $filepath );
my $instance = G:P:Distmap->load( filehandle => $fh );
my $instance = G:P:Distmap->load( string => $str );

decoder

$decoder = G:P:Distmap->decoder();

encoder

$encoder = G:P:Distmap->encoder();

ATTRIBUTE METHODS

map -> map

multi_repository_dists -> map

all_mapped_dists -> map

mapped_dists -> map

dists_in_repository -> map

add_version -> map

PRIVATE METHODS

_save_string

_save_filehandle

_save_file

PRIVATE CLASS METHODS

_load_file

_load_filehandle

_load_string

AUTHOR

Kent Fredric <kentfredric@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Kent Fredric <kentfredric@gmail.com>.

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