NAME

ceylon src - Fetches source archives from a repository and extracts their contents into a source directory

SYNOPSIS

ceylon src
[--cacherep=url] [--cwd=dir] [--doc=dirs] [--maven-overrides=file] [--no-default-repositories] [--offline] [--overrides=file] [--rep=url...] [--resource=dir] [--resource-root=folder-name] [--script=dir] [--source=dir] [--src=dir] [--sysrep=url] [--timeout=seconds] [--verbose[=flags]] [--] {module}...

DESCRIPTION

Fetches any sources, resources, documentation and scripts that can be found for given module from the first configured repository to contain the module and extracts the them into their respective output directories. Multiple modules can be given.

This tool is especially useful for working with example projects.

OPTIONS

--cacherep=url

Specifies the folder to use for caching downloaded modules. (default: ~/.ceylon/cache)

--cwd=dir

Specifies the current working directory for this tool. (default: the directory where the tool is run from)

--doc=dirs

The output doc directory (default: ./doc)

--maven-overrides=file

Specifies the XML file to use to load Maven artifact overrides. See http://ceylon-lang.org/documentation/current/reference/repository/maven/ for information. Deprecated: use --overrides.

--no-default-repositories

Indicates that the default repositories should not be used.

--offline, -L

Enables offline mode that will prevent connections to remote repositories.

--overrides=file, -O file

Specifies the XML file to use to load module overrides. See http://ceylon-lang.org/documentation/current/reference/repository/maven/ for information. null.

--rep=url

Specifies a module repository containing dependencies. Can be specified multiple times. (default: modules, ~/.ceylon/repo, https://modules.ceylon-lang.org/repo/1)

--resource=dir, -r dir

The output resource directory (default: ./resource)

--resource-root=folder-name, -R folder-name

Sets the special resource folder name whose files will end up in the root of the resulting module CAR file (default: ROOT).

--script=dir, -x dir

The output script directory (default: ./script)

--source=dir

An alias for --src (default: ./source)

--src=dir, -s dir

The output source directory (default: ./source)

--sysrep=url

Specifies the system repository containing essential modules. (default: $CEYLON_HOME/repo)

--timeout=seconds, -T seconds

Sets the timeout for connections to remote repositories, use 0 for no timeout (default: 20).

--verbose[=flags], -d

Produce verbose output. If no flags are given then be verbose about everything, otherwise just be verbose about the flags which are present. Allowed flags include: all, loader.

EXAMPLES

A typical workflow might be:

mkdir my-project
cd my-project
ceylon src org.example.foo
ceylon compile org.example.foo
ceylon run org.example.foo