NAME

Shipwright::Script::Import - import a source and its dependencies

SYNOPSIS

import SOURCE

OPTIONS

-r [--repository] REPOSITORY   : specify the repository of our project
-l [--log-level] LOGLEVEL      : specify the log level
--log-file FILENAME            : specify the log file
-m [--comment] COMMENT         : specify the comment
--name NAME                    : specify the source name (only alphanumeric
                                 characters, . and -)
--build-script FILENAME        : specify the build script
--require-yml FILENAME         : specify the require.yml
--no-follow                    : don't follow the dependency chain
--extra-test FILENAME          : specify the extra test source
                                 (for --only-test when building)
--test-script FILENAME         : specify the test script (for --only-test when
                                 building)
--min-perl-version             : minimal perl version (default is the same as
                                 the one which runs this command)
--overwrite                    : import dependency dists anyway even if they
                                 are already in the repository
--version                      : specify the source's version

DESCRIPTION

The import command imports a new dist into a shipwright repository from any of a number of supported source types (enumerated below). If a dist of the name specified by --name already exists in the repository, the old files for that dist in /dists and /scripts are deleted and new ones added. This is the recommended method for updating non-svn, svk, or CPAN dists to new versions (see Shipwright::Update for more information on the update command, which is used for updating svn, svk, and CPAN dists).

SUPPORTED SOURCE TYPES

Generally, the format is type:schema; be careful, there is no blank between type and schema, just a colon.

CPAN

e.g. cpan:Jifty::DBI cpan:File::Spec

File

e.g. file:/home/sunnavy/foo-1.23.tar.gz file:/home/sunnavy/foo-1.23.tar.bz2 file:/home/sunnavy/foo-1.23.tgz

Directory

e.g. directory:/home/sunnavy/foo-1.23 dir:/home/sunnavy/foo-1.23

HTTP

e.g. http:http://example/foo-1.23.tar.gz

You can also omit one `http', like this:

http://example.com/foo-1.23.tar.gz

.tgz and .tar.bz2 are also supported.

FTP

e.g. ftp:ftp://example.com/foo-1.23.tar.gz ftp://example.com/foo-1.23.tar.gz

.tgz and .tar.bz2 are also supported.

SVK

e.g. svk://public/foo-1.23 svk:/local/foo-1.23

SVN

e.g. svn:file:///home/public/foo-1.23 svn:http://svn.example.com/foo-1.23