NAME

OPM::Repository - parse OPM repositories' framework.xml files to search for add ons

VERSION

version 1.0.0

SYNOPSIS

            

              
              
use OPM::Repository;
my $repo = OPM::Repository->new(
    sources => [qw!
        https://opar.perl-services.de/framework.xml
        https://download.znuny.org/releases/packages/framework.xml
        https://download.znuny.org/releases/itsm/packages6/framework.xml
    !],
);
my ($url) = $repo->find(
  name      => 'ITSMCore',
  framework => '3.3',
);
print $url;
            
          

BUILDARGS

ATTRIBUTES

• sources

METHODS

new

new has only one mandatory parameter: sources. This has to be an array reference of URLs for repositories' framework.xml files.

            

              
              
my $repo = OPM::Repository->new(
    sources => [qw!
        http://opar.perl-services.de/framework.xml
        http://ftp.framework.org/pub/framework/packages/framework.xml
        http://ftp.framework.org/pub/framework/itsm/packages33/framework.xml
    !],
);
            
          

find

Search for an add on for a given OPM version in those repositories. It returns a list of urls if the add on was found, undef otherwise.

            

              
              
my @urls = $repo->find(
  name      => 'ITSMCore',
  framework => '3.3',
);
            
          

Find a specific version

            

              
              
my @urls = $repo->find(
  name      => 'ITSMCore',
  framework => '3.3',
  version   => '1.4.8',
);
            
          

list

List all addons found in the repositories

            

              
              
my @addons = $repo->list;
say $_ for @addons;
            
          

You can also define the OPM version

            

              
              
my @addons = $repo->list( framework => '5.0.x' );
say $_ for @addons;
            
          

Both snippets print a simple list of addon names. If you want to to create a list with more information, you can use

            

              
              
my @addons = $repo->list(
    framework => '5.0.x',
    details   => 1,
);
say sprintf "%s (%s) on %s\n", $_->{name}, $_->{version}, $_->{url} for @addons;
            
          

AUTHOR

Renee Baecker <reneeb@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2017 by Renee Baecker.

This is free software, licensed under:

            

              
              
The Artistic License 2.0 (GPL Compatible)
            
          

cpanm OPM::Repository

perl -MCPAN -e shell
install OPM::Repository