NAME Pinto - Perl distribution repository manager VERSION version 0.012 SYNOPSIS You probably want to look at the documentation for pinto-admin. All the modules in this distribution are private (for now). So the API documentation is purely for my own reference. But this document does explain what Pinto does and why it exists, so feel free to read on anyway. METHODS create() Creates a new empty repository. mirror() Populates your repository with the latest version of all distributions found in the foreign repository (which is usually a CPAN mirror). Your locally added distributions will always mask those mirrored from the remote repository. add(dists => ['YourDist.tar.gz'], author => 'SOMEONE') remove(packages => ['Some::Package'], author => 'SOMEONE') clean() list() verify() DISCUSSION Pinto is a set of tools for creating and managing a CPAN-style repository. This repository can contain just your own private distributions, or you can fill it with the latest ones from a CPAN mirror, or both. You can then use your favorite CPAN client to fetch distributions from your repository and install them as you normally would. Pinto shares a lot of DNA with CPAN::Site, CPAN::Mini, and CPAN::Mini::Inject. But I wasn't entirely satisfied with those, so I built a (hopefully better) mousetrap. Pinto is not magic pixie dust though. It does not guarantee that you will always have a working stack of distributions. It is still up to you to figure out what to put in your repository. Pinto just gives you a set of tools for doing that in a controlled manner. This is a work in progress. Comments, criticisms, and suggestions are always welcome. Feel free to contact "thaljef@cpan.org". WHY IS IT CALLED "Pinto" The term "CPAN" is heavily overloaded. In some contexts, it means the CPAN module or the cpan utility. In other contexts, it means a mirror like or a web site like . I wanted to avoid all that confusion, so I picked a name that has no connection to "CPAN" at all. "Pinto" is a nickname that I sometimes call my son, Wesley. THANKS Randal Schwartz - for pioneering the first mini CPAN back in 2002 Ricardo Signes - for creating CPAN::Mini, which inspired much of Pinto Shawn Sorichetti & Christian Walde - for creating CPAN::Mini::Inject George Hartzell @ Genentech - for sponsoring this project SUPPORT Perldoc You can find documentation for this module with the perldoc command. perldoc Pinto Websites The following websites have more information about this module, and may be of help to you. As always, in addition to those websites please use your favorite search engine to discover more resources. * Search CPAN The default CPAN search engine, useful to view POD in HTML format. * RT: CPAN's Bug Tracker The RT ( Request Tracker ) website is the default bug/issue tracking system for CPAN. * CPAN Ratings The CPAN Ratings is a website that allows community ratings and reviews of Perl modules. * CPAN Testers The CPAN Testers is a network of smokers who run automated tests on uploaded CPAN distributions. * CPAN Testers Matrix The CPAN Testers Matrix is a website that provides a visual way to determine what Perls/platforms PASSed for a distribution. * CPAN Testers Dependencies The CPAN Testers Dependencies is a website that shows a chart of the test results of all dependencies for a distribution. Bugs / Feature Requests Please report any bugs or feature requests by email to "bug-pinto at rt.cpan.org", or through the web interface at . You will be automatically notified of any progress on the request by the system. Source Code git clone https://github.com/thaljef/Pinto AUTHOR Jeffrey Ryan Thalhammer COPYRIGHT AND LICENSE This software is copyright (c) 2011 by Imaginative Software Systems. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.