/ 
Pinto-Common-0.065_01
/ Pinto::Manual::QuickStart

NAME

Pinto::Manual::QuickStart - A condensed summary of Pinto

VERSION

version 0.065_01

CREATING THE REPOSITORY

# A new repository with default stack named "master"
pinto -r /repo/dir

# A new repository with default stack named "dev"
pinto -r /repo/dir dev

BROWSING THE REPOSITORY

# See all packages in the default stack
pinto -r /repo/dir list

# See all packages in the default stack matching "Foo::Bar"
pinto -r /repo/dir list -P Foo::Bar

# See all packages in the default stack by author "JOE"
pinto -r /repo/dir list -A JOE

# See all packages in the "dev" stack
pinto -r /repo/dir list --stack dev
pinto -r /repo/dir list dev

PULLING UPSTREAM DISTRIBUTIONS

# Pull latest version of Foo::Bar
pinto -r /repo/dir pull Foo::Bar

# Pull version 2.4 or newer of Foo::Bar
pinto -r /repo/dir pull Foo~2.4

# Pull a specific distribution
pinto -r /repo/dir pull AUTHOR/Foo-Bar-1.9.tar.gz

# Pull and pin at the same time
pinto -r /repo/dir pull --pin Foo::Bar~2.4

# Pull many packages or distributions
pinto -r /repo/dir pull Foo::Bar Baz::Qux ...
pinto -r /repo/dir pull < LIST_OF_PACKAGES

# Pull everything for a Dist::Zilla project
dzil listdeps | pinto -r /repo/dir pull

# Pull onto the "dev" stack
pinto -r /repo/dir pull --stack dev Foo::Bar

ADDING LOCAL DISTRIBUTIONS

# Add a local dist to the default stack
pinto -r /repo/dir add My-Dist-1.0.tar.gz

# Assign to a different author
pinto -r /repo/dir add --author SHAKESPEARE My-Dist-1.0.tar.gz

# Add and pin at the same time
pinto -r /repo/dir add --pin My-Dist-1.0.tar.gz

# Add to the "dev" stack
pinto -r /repo/dir add --stack dev My-Dist-1.0.tar.gz

INSTALLING THINGS

# Install from the default stack using using cpanm
cpanm --mirror file:///repo/dir --mirror-only Foo::Bar

# Install from the "dev" stack using using cpanm
cpanm --mirror file:///repo/dir/stacks/dev --mirror-only Foo::Bar

# Install from the default stack using pinto
pinto -r /repo/dir install Foo::Bar

# Install from the "dev" stack using pinto
pinto -r /repo/dir --stack dev install Foo::Bar

# Install and populate the repository with missing prereqs
pinto -r /repo/dir install --pull Foo::Bar

MANAGING STACKS

# Create an empty stack named "qa"
pinto -r /repo/dir new qa

# Create a stack by copying "dev" to "qa"
pinto -r /repo/dir copy dev qa

# Delete the dev stack
pinto -r /repo/dir kill dev

# Rename the "dev" stack to "prod"
pinto -r /repo/dir rename dev prod

# Mark the "qa" stack as the default
pinto -r /repo/dir default qa

# Show config properties of the default stack
pinto -r /repo/dir props

# Set config properties of the default stack
pinto -r /repo/dir props --property NAME=VALUE

# Show all the existing stacks
pinto -r /repo/dir stacks

USING PINS

# Pin a package on the default stack
pinto -r /repo/dir pin Foo::Bar

# Pin a package on the "dev" stack
pinto -r /repo/dir pin --stack dev Foo::Bar

# Pin a distribution
pinto -r /repo/dir pin AUTHOR/Foo-Bar-1.0.tar.gz

# Unpin a package from the default stack
pinto -r /repo/dir unpin Fo::Bar

# Unpin a package from the "dev" stack
pinto -r /repo/dir unpin --stack dev Foo::Bar

# Unpin a distribution
pinto -r /repo/dir unpin AUTHOR/Foo-Bar-1.0.tar.gz

VERSION CONTROL

# View commit messages for the default stack
pinto -r /repo/dir log

# View commit messages for the "dev" stack
pinto -r /repo/dir log dev

# Compare the heads of the default and "qa" stacks
pinto -r /repo/dir diff qa

# Compare the heads of the "dev" and "qa" stacks
pinto -r /repo/dir diff dev qa

MISCELLANY

# Report missing distribution archives
pinto -r /repo/dir verify

# Report repo statistics
pinto -r /repo/dir stats

# Remove orphan files and tune the database
pinto -r /repo/dir clean

GETTING MORE HELP

# Show a list of pinto commands
pinto commands

# Show a brief summary of a COMMAND
pinto help COMMAND

# Show the manual for a COMMAND
pinto manual COMMAND

SEE ALSO

Pinto::Manual::Tutorial

Pinto

pinto

AUTHOR

Jeffrey Ryan Thalhammer <jeff@imaginative-software.com>

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.