pinto-admin - administer a Pinto repository
version 0.029
pinto-admin --repos=/path/to/repos [global options] COMMAND [command options] [ARGS]
pinto-admin is a command line utility for creating and managing a local Pinto repository. The repository can contain your own distributions and/or foreign distributions from another repository (such as a CPAN mirror). You can also put locally patched versions of foreign distributions in your repository. Then you can then point cpan (or cpanm or cpanp) at your Pinto repository and build/install your distributions.
pinto-admin
# Create an empty repository at /some/dir pinto-admin --repos=/some/dir create # Add your own distribution to the repository pinto-admin --repos=/some/dir add Foo-Bar-1.2.tar.gz # Fetch a module and all its dependencies pinto-admin --repos=/some/dir import Plack # Fetch the latest version of all modules pinto-admin --repos=/some/dir mirror # Then install stuff, forcing everything to come from your repository cpanm --mirror-only --mirror file:///some/dir Foo::Bar # Or install stuff, falling back to a CPAN for missing dependencies cpanm --mirror file:///some/dir Foo::Bar
The following options are available for all commands.
Specifies the path to the root directory of your repository. This is mandatory for all commands unless you've set the PINTO_REPOSITORY environment variable to point to your repository.
PINTO_REPOSITORY
Do not colorize diagnostic messages according to severity.
Report only fatal errors. This option silently overrides the --verbose options.
--verbose
Display more diagnostic messages. This switch can be repeated multiple times for greater effect.
pinto-admin supports several commands that perform various operations on your repository, or report information about your repository. To get a listing of all the available commands:
$> pinto-admin commands
Each command has its own options and arguments. To get a brief summary:
$> pinto-admin help COMMAND
To see the complete manual for a command:
$> pinto-admin manual COMMAND
The .pinto/config directory of every repository contains a configuration file named pinto.ini. This file will be generated for you whenever you create a new repository. Thereafter, it is up to you to manually adjust the configuration file as you see fit.
The configuration file is in the typical INI-file format. Parameters are NAME = VALUE pairs. Blank lines are ignored, leading and trailing whitespace is discarded. Comments start with a semi-colon (;).
NAME = VALUE
If true, Pinto will allow development releases to appear in the index when they are the "latest" version. Otherwise, development releases are accepted into the repository but never included in the index. Defaults to 0.
A space-delimited list of the URLs of the repositories that Pinto will pull foreign distributions from. These could be public CPAN mirrors, a private CPAN::Mini mirror, or other Pinto repositories. Defaults to http://cpan.perl.org.
If true, Pinto will not pull/update the repository from the VCS before each operation. This is only relevant if you are using a VCS‐based storage mechanism. This can speed up operations considerably, but should only be used if you *know* that your working copy is up‐to‐date and you are going to be the only actor touching the Pinto repository within the VCS. Defaults to 0.
The name of the class that will handle storage of your Pinto repository. The default is Pinto::Store, which simply stores your repository on the local file system. Alternatives Stores like Pinto::Store::VCS::Svn and Pinto::Store::VCS::Git will also store your repository inside a version control system (VCS). See the documentation for each of those modules for information on setting up Pinto with a VCS.
Pinto::Manual for detailed information on using the Pinto tools.
pinto-server to allow remote access to your Pinto repository.
pinto-remote to interact with a remote Pinto repository.
Jeffrey Ryan Thalhammer <jeff@imaginative-software.com>
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.
1 POD Error
The following errors were encountered while parsing the POD:
Non-ASCII character seen before =encoding in 'VCS‐based'. Assuming UTF-8
To install Pinto, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Pinto
CPAN shell
perl -MCPAN -e shell install Pinto
For more information on module installation, please visit the detailed CPAN module installation guide.