CONTENTS

• NAME
• VERSION
• INSTALLING PINTO
• CREATING A REPOSITORY
• BROWSING A REPOSITORY
• PULLING UPSTREAM DISTRIBUTIONS
• ADDING LOCAL DISTRIBUTIONS
• INSTALLING THINGS
• MANAGING STACKS
• USING PINS
• VERSION CONTROL
• MISCELLANY
• GETTING MORE HELP
• SEE ALSO
• AUTHOR
• COPYRIGHT AND LICENSE

#NAME

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

#VERSION

version 0.14

#INSTALLING PINTO

curl -L http://getpinto.stratopan.com | bash
source ~/opt/local/pinto/etc/bashrc

#CREATING A REPOSITORY

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

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

#BROWSING A REPOSITORY

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

# See all packages in the default stack matching m/Foo::Bar/i
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 any 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 exactly version 2.4 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 cpanm
cpanm --mirror file:///repo/dir --mirror-only Foo::Bar

# Install from the "dev" stack 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 --do-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

# Merge "dev" stack into the "qa" stack (fast-forward only)
pinto -r /repo/dir merge 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

# Report top-level distributions of the default stack
pinto -r /repo/dir roots

#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::Manual::Installing

Pinto (the library)

pinto (the command)

#AUTHOR

Jeffrey Ryan Thalhammer <jeff@stratopan.com>

#COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by Jeffrey Ryan Thalhammer.

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

CPANdoc Browser is maintained by Dan Book (DBOOK). Please contact him via the GitHub issue tracker or email regarding any issues with the site itself, search, or rendering of documentation.

CPAN module documentation is maintained by each author and maintainer individually. Please contact them via the mechanisms listed in their documentation or on the module's MetaCPAN page to report any issues with the contents or format of the documentation.