1Shipwright::Manual::UsiUnsgeBrraCnocnhtersi(b3u)ted PerlShDiopcwurmiegnhtta:t:iMoannual::UsingBranches(3)
2
3
4

NAME

6       Shipwright::Manual::UsingBranches - Using branches
7

DESCRIPTION

9       Shipwright branches is a method to keep multiple sources for one
10       source, a bit like branches in vcs.  Technically, all the sources for
11       foo live below sources/foo/.
12
13       Sources from CPAN can't be branched, or in the other way, can only have
14       one branch.  Technically, only dists occurred in shipwright/source.yml
15       can be branched.
16
17       Imagine we have an app Foo, of which the layout in vcs is like:
18       trunk/...  branches/1.0/...  branches/2.0/...
19
20       With branches support, we can add all the 3 versions in shipwright:
21
22           $ shipwright import -r ... svn:.../trunk --name Foo --as trunk
23           $ shipwright import -r ... svn:.../branches/1.0 --name Foo --as branches/1.0
24           $ shipwright import -r ... svn:.../branches/2.0 --name Foo --as branches/2.0
25
26       the branch names can be whatever you want, no need to be the same
27       layout as your vcs system now we have trunk, 1.0 and 2.0 branches in
28       shipwright:
29
30           $ shipwright list -r ... Foo
31
32       will show "branches: trunk, branches/1.0, branches/2.0"
33
34       When build, the 1st one will be treated as the default branch.  to
35       change the default branch, e.g. we want to change 2.0 as the default:
36
37           $ shipwright defaultbranch -r ... Foo branches/2.0
38
39       If we don't want to change the default branch, we can also supply
40       --branch arg when build:
41
42           $ ./bin/shipwright-builder --branches Foo=branches/2.0
43
44       Note:
45
46       Since all these branches share the same build script and the same dep
47       sources, if branches are way too different, it's better to import it as
48       another source instead of branching.
49

SEE ALSO

51       Shipwright, Shipwright::Manual
52

AUTHORS

54       sunnavy  "<sunnavy@bestpractical.com>"
55

57       Shipwright is Copyright 2007-2015 Best Practical Solutions, LLC.
58
59       This program is free software; you can redistribute it and/or modify it
60       under the same terms as Perl itself.
61
62
63
64perl v5.36.0                      2022-07-2S2hipwright::Manual::UsingBranches(3)
Impressum