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-all-build-requires      : skip all the build requires to import
34        --skip-installed               : skip all the installed modules to import
35        --include-dual-lifed           : include modules which live both in the perl core
36                                         and on CPAN
37        --no-default-build             : don't try to detect and set build system
38

DESCRIPTION

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

SUPPORTED SOURCE TYPES

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

GLOBAL OPTIONS

95        -r [--repository] REPOSITORY   : specify the repository uri of our shipyard
96        -l [--log-level] LOGLEVEL      : specify the log level
97                                         (info, debug, warn, error, or fatal)
98        --log-file FILENAME            : specify the log file
99

AUTHORS

101       sunnavy  "<sunnavy@bestpractical.com>"
102

104       Shipwright is Copyright 2007-2015 Best Practical Solutions, LLC.
105
106       This program is free software; you can redistribute it and/or modify it
107       under the same terms as Perl itself.
108
109
110
111perl v5.36.0                      2023-01-20     Shipwright::Script::Import(3)
Impressum