Peter Shangov > CPAN-Local-Plugin-DistroList-0.003 > CPAN::Local::Plugin::DistroList

Download:
CPAN-Local-Plugin-DistroList-0.003.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.003   Source  

NAME ^

CPAN::Local::Plugin::DistroList - Populate a mirror with a list of distributions

VERSION ^

version 0.003

SYNOPSIS ^

In cpanlocal.ini:

  ; Add distros from backan
  [DistroList / Backpan]
  list   = backpan.distrolist
  prefix = http://backpan.perl.org/authors/id/
  cache  = /home/user/backpan/cache

  ; Add distros from filesystem
  [DistroList / Local]
  list     = local.distrolist
  prefix   = /home/user/distros/
  local    = 1
  authorid = MYCOMPANY

In backpan.distrolist:

  A/AB/ABH/Apache-DBI-0.94.tar.gz
  A/AB/ABIGAIL/Regexp-Common-1.30.tar.gz
  A/AB/ABW/Class-Base-0.03.tar.gz
  ...

In local.distrolist:

  My-Great-App-001.tar.gz
  My-Great-App-002.tar.gz
  ...

Then simply update the repo from the command line:

  % lpan update

DESCRIPTION ^

This plugin allows you to add distributions from a list of filenames or uris. The list is read from a configuration file containing one distribution name per line.

IMPLEMENTS ^

CPAN::Local::Role::Gather

ATTRIBUTES ^

list

Required. Path to the configuration file that contains the list of distributions. The configuration file must contain absolute paths or uris, unless "prefix" is specified.

prefix

Optional. String to prepend to each line in the configuration file. This is commonly the base uri of a CPAN mirror or the path to a local folder containing distributions. Note that the prefix is simply concatenated with each line in the configuration file, so be careful not to omit the trailing slash where needed.

cache

Optional. Directory where to download a remote distribution before adding it to the mirror. If a distribtuion from the configuartion file is already in the cache, it will not be downloaded again. Ignored when "local" is used.

local

Optional. Instructs the plugin that the distributions live in the local filesystem, so no attempt will be made to download or cache them.

authorid

Optional. Author id to use when injecting distributions from this list.

AUTHOR ^

Peter Shangov <pshangov@yahoo.com>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2012 by Venda, Inc..

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

syntax highlighting: