NAME

App::Pinto::Command::pull - pull archives from upstream repositories

VERSION

version 0.043

SYNOPSIS

pinto --root=REPOSITORY_ROOT pull [OPTIONS] TARGET ...
pinto --root=REPOSITORY_ROOT pull [OPTIONS] < LIST_OF_TARGETS

DESCRIPTION

This command locate packages in your upstream repositories and then pulls the distributions providing those packages into your repository. Then it recursively locates and pulls all the distributions that are necessary to satisfy their prerequisites. You can also request to directly pull particular distributions.

When locating packages, Pinto first looks at the the packages that already exist in the local repository, then Pinto looks at the packages that are available available on the upstream repositories.

You can also use this command to simply put packages into one stack or another, and those packages (or their prerequisites) may or may not already be in the repository.

COMMAND ARGUMENTS

Arguments are the targets that you want to pull. Targets can be specified as packages (with or without a minimum version number) or a distributions. For example:

Foo::Bar                                 # Pulls any version of Foo::Bar
Foo::Bar~1.2                             # Pulls Foo::Bar 1.2 or higher
SHAKESPEARE/King-Lear-1.2.tar.gz         # Pulls a specific distribuion
SHAKESPEARE/tragedies/Hamlet-4.2.tar.gz  # Ditto, but from a subdirectory

You can also pipe arguments to this command over STDIN. In that case, blank lines and lines that look like comments (i.e. starting with "#" or ';') will be ignored.

COMMAND OPTIONS

--dryrun

Go through all the motions, but do not actually commit any changes to the repository. Use this option to see how upgrades would potentially impact the stack.

--norecurse

Do not recursively pull any distributions required to satisfy prerequisites for the targets.

--stack=NAME

Puts all the packages onto the stack with the given NAME. Defaults to the name of whichever stack is currently marked as the default stack. Use the stacks command to see the stacks in the repository.

AUTHOR

Jeffrey Thalhammer <jeff@imaginative-software.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 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.