1Shipwright::Script::ImpUosretr(3C)ontributed Perl DocumeSnhtiaptwiroinght::Script::Import(3)
2
3
4

NAME

6       Shipwright::Script::Import - Import sources and their dependencies
7

SYNOPSIS

9        shipwright import cpan:Jifty cpan:Catalyst
10

OPTIONS

12        -m [--comment] COMMENT         : specify the comment
13        --name NAME                    : specify the source name (only alphanumeric
14                                         characters, . and -)
15        --as                           : the branch name
16        --build-script FILENAME        : specify the build script
17        --require-yml FILENAME         : specify the require.yml
18        --no-follow                    : don't follow the dependency chain
19        --extra-test FILENAME          : specify the extra test source
20                                         (for --only-test when building)
21        --test-script FILENAME         : specify the test script (for --only-test when
22                                         building)
23        --min-perl-version             : minimal perl version (default is the same as
24                                         the one which runs this command)
25        --overwrite                    : import dependency sources anyway even if they
26                                         are already in the shipyard
27        --version                      : specify the source's version
28        --skip                         : specify a list of sources not to import
29        --skip-recommends              : specify a list of sources of which recommends
30                                         not to import
31        --skip-all-recommends          : skip all the recommends to import
32        --skip-all-test-requires       : skip all the test requires to import
33        --skip-installed               : skip all the installed modules to import
34        --include-dual-lifed           : include modules which live both in the perl core
35                                         and on CPAN
36

DESCRIPTION

38       The import command imports a new source into a shipyard from a number
39       of supported source types (enumerated below). If a source of the name
40       specified by "--name" already exists in the shipyard, the old files for
41       that source in /sources and /scripts are deleted and new ones are
42       added. This is the recommended method for updating non-svn, svk, or
43       CPAN sources to new versions.  (see Shipwright::Script::Update for more
44       information on the "update" command, which is used for updating svn,
45       svk, and CPAN dists).
46

SUPPORTED SOURCE TYPES

48       Generally, the format is <type:schema>; be careful, there is no blank
49       between type and schema, just a colon.
50
51       CPAN
52           e.g. cpan:Jifty::DBI  cpan:File::Spec
53
54           CAVEAT: we don't support renaming CPAN sources when importing,
55           because it *really* is not a good idea and may hurt shipwright
56           somewhere.
57
58       File
59           e.g. file:/home/sunnavy/foo-1.23.tar.gz
60           <file:/home/sunnavy/foo-1.23.tar.gz>
61           file:/home/sunnavy/foo-1.23.tar.bz2
62           <file:/home/sunnavy/foo-1.23.tar.bz2>
63           file:/home/sunnavy/foo-1.23.tgz <file:/home/sunnavy/foo-1.23.tgz>
64
65       Directory
66           e.g. directory:/home/sunnavy/foo-1.23
67           <directory:/home/sunnavy/foo-1.23> dir:/home/sunnavy/foo-1.23
68           <dir:/home/sunnavy/foo-1.23>
69
70       HTTP
71           e.g. http:http://example/foo-1.23.tar.gz
72           <http:http://example/foo-1.23.tar.gz>
73
74           You can also omit one `http', like this:
75
76           http://example.com/foo-1.23.tar.gz
77           <http://example.com/foo-1.23.tar.gz>
78
79           .tgz and .tar.bz2 are also supported.
80
81       FTP e.g. ftp:ftp://example.com/foo-1.23.tar.gz
82           <ftp:ftp://example.com/foo-1.23.tar.gz>
83           ftp://example.com/foo-1.23.tar.gz
84           <ftp://example.com/foo-1.23.tar.gz>
85
86           .tgz and .tar.bz2 are also supported.
87
88       SVK e.g. svk://public/foo-1.23 <svk://public/foo-1.23>
89           svk:/local/foo-1.23 <svk:/local/foo-1.23>
90
91       SVN e.g. svn:file:///home/public/foo-1.23
92           <svn:file:///home/public/foo-1.23>
93           svn:http://svn.example.com/foo-1.23
94           <svn:http://svn.example.com/foo-1.23>
95
96       Git e.g. <git:file:///opt/foo.git>
97           <git://github.com/bestpractical/shipwright.git>
98
99       Shipyard
100           e.g. <shipyard:/tmp/fs/foo>
101

GLOBAL OPTIONS

103        -r [--repository] REPOSITORY   : specify the repository uri of our shipyard
104        -l [--log-level] LOGLEVEL      : specify the log level
105                                         (info, debug, warn, error, or fatal)
106        --log-file FILENAME            : specify the log file
107

AUTHORS

109       sunnavy  "<sunnavy@bestpractical.com>"
110

112       Shipwright is Copyright 2007-2010 Best Practical Solutions, LLC.
113
114       This program is free software; you can redistribute it and/or modify it
115       under the same terms as Perl itself.
116
117
118
119perl v5.12.3                      2011-02-28     Shipwright::Script::Import(3)
Impressum