Pinto::Manual::QuickStart(3pm)

1Pinto::Manual::QuickStaUrste(r3)Contributed Perl DocumenPtianttioo:n:Manual::QuickStart(3)
2
3
4

NAME

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

VERSION

9       version 0.14
10

INSTALLING PINTO

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

CREATING A REPOSITORY

16         # A new repository with default stack named "master"
17         pinto -r /repo/dir init
18         pinto init /repo/dir
19
20         # A new repository with default stack named "dev"
21         pinto -r /repo/dir init --stack dev
22

BROWSING A REPOSITORY

24         # See all packages in the default stack
25         pinto -r /repo/dir list
26
27         # See all packages in the default stack matching m/Foo::Bar/i
28         pinto -r /repo/dir list -P Foo::Bar
29
30         # See all packages in the default stack by author "JOE"
31         pinto -r /repo/dir list -A JOE
32
33         # See all packages in the "dev" stack
34         pinto -r /repo/dir list --stack dev
35         pinto -r /repo/dir list dev
36

PULLING UPSTREAM DISTRIBUTIONS

38         # Pull any version of Foo::Bar
39         pinto -r /repo/dir pull Foo::Bar
40
41         # Pull version 2.4 or newer of Foo::Bar
42         pinto -r /repo/dir pull Foo~2.4
43
44         # Pull exactly version 2.4 of Foo::Bar
45         pinto -r /repo/dir pull Foo==2.4
46
47         # Pull a specific distribution
48         pinto -r /repo/dir pull AUTHOR/Foo-Bar-1.9.tar.gz
49
50         # Pull and pin at the same time
51         pinto -r /repo/dir pull --pin Foo::Bar~2.4
52
53         # Pull many packages or distributions
54         pinto -r /repo/dir pull Foo::Bar Baz::Qux ...
55         pinto -r /repo/dir pull < LIST_OF_PACKAGES
56
57         # Pull everything for a Dist::Zilla project
58         dzil listdeps | pinto -r /repo/dir pull
59
60         # Pull onto the "dev" stack
61         pinto -r /repo/dir pull --stack dev Foo::Bar
62

ADDING LOCAL DISTRIBUTIONS

64         # Add a local dist to the default stack
65         pinto -r /repo/dir add My-Dist-1.0.tar.gz
66
67         # Assign to a different author
68         pinto -r /repo/dir add --author SHAKESPEARE My-Dist-1.0.tar.gz
69
70         # Add and pin at the same time
71         pinto -r /repo/dir add --pin My-Dist-1.0.tar.gz
72
73         # Add to the "dev" stack
74         pinto -r /repo/dir add --stack dev My-Dist-1.0.tar.gz
75

INSTALLING THINGS

77         # Install from the default stack using cpanm
78         cpanm --mirror file:///repo/dir --mirror-only Foo::Bar
79
80         # Install from the "dev" stack using cpanm
81         cpanm --mirror file:///repo/dir/stacks/dev --mirror-only Foo::Bar
82
83         # Install from the default stack using pinto
84         pinto -r /repo/dir install Foo::Bar
85
86         # Install from the "dev" stack using pinto
87         pinto -r /repo/dir --stack dev install Foo::Bar
88
89         # Install and populate the repository with missing prereqs
90         pinto -r /repo/dir install --do-pull Foo::Bar
91

MANAGING STACKS

93         # Create an empty stack named "qa"
94         pinto -r /repo/dir new qa
95
96         # Create a stack by copying "dev" to "qa"
97         pinto -r /repo/dir copy dev qa
98
99         # Delete the dev stack
100         pinto -r /repo/dir kill dev
101
102         # Rename the "dev" stack to "prod"
103         pinto -r /repo/dir rename dev prod
104
105         # Mark the "qa" stack as the default
106         pinto -r /repo/dir default qa
107
108         # Show config properties of the default stack
109         pinto -r /repo/dir props
110
111         # Set config properties of the default stack
112         pinto -r /repo/dir props --property NAME=VALUE
113
114         # Show all the existing stacks
115         pinto -r /repo/dir stacks
116

USING PINS

118         # Pin a package on the default stack
119         pinto -r /repo/dir pin Foo::Bar
120
121         # Pin a package on the "dev" stack
122         pinto -r /repo/dir pin --stack dev Foo::Bar
123
124         # Pin a distribution
125         pinto -r /repo/dir pin AUTHOR/Foo-Bar-1.0.tar.gz
126
127         # Unpin a package from the default stack
128         pinto -r /repo/dir unpin Fo::Bar
129
130         # Unpin a package from the "dev" stack
131         pinto -r /repo/dir unpin --stack dev Foo::Bar
132
133         # Unpin a distribution
134         pinto -r /repo/dir unpin AUTHOR/Foo-Bar-1.0.tar.gz
135

VERSION CONTROL

137         # View commit messages for the default stack
138         pinto -r /repo/dir log
139
140         # View commit messages for the "dev" stack
141         pinto -r /repo/dir log dev
142
143         # Compare the heads of the default and "qa" stacks
144         pinto -r /repo/dir diff qa
145
146         # Compare the heads of the "dev" and "qa" stacks
147         pinto -r /repo/dir diff dev qa
148
149         # Merge "dev" stack into the "qa" stack (fast-forward only)
150         pinto -r /repo/dir merge dev qa
151

MISCELLANY

153         # Report missing distribution archives
154         pinto -r /repo/dir verify
155
156         # Report repo statistics
157         pinto -r /repo/dir stats
158
159         # Remove orphan files and tune the database
160         pinto -r /repo/dir clean
161
162         # Report top-level distributions of the default stack
163         pinto -r /repo/dir roots
164

GETTING MORE HELP

166         # Show a list of pinto commands
167         pinto commands
168
169         # Show a brief summary of a COMMAND
170         pinto help COMMAND
171
172         # Show the manual for a COMMAND
173         pinto manual COMMAND
174

AUTHOR

185       Jeffrey Ryan Thalhammer <jeff@stratopan.com>
186

COPYRIGHT AND LICENSE

188       This software is copyright (c) 2015 by Jeffrey Ryan Thalhammer.
189
190       This is free software; you can redistribute it and/or modify it under
191       the same terms as the Perl 5 programming language system itself.
192
193
194
195perl v5.36.0                      2022-07-22      Pinto::Manual::QuickStart(3)