ceylon import-jar(1) ceylon import-jar(1)NAME
ceylon import-jar - Imports a jar file into a Ceylon module repository
SYNOPSIS
ceylon import-jar [--cacherep=url] [--cwd=dir] [--descriptor=file]
[--dry-run] [--force] [--maven-overrides=url] [--no-
default-repositories] [--offline] [--out=url]
[--overrides=url] [--pass=secret] [--rep=url...]
[--show-classes] [--show-suggestions] [--sysrep=url]
[--timeout=seconds] [--update-descriptor]
[--user=name] [--verbose[=flags]] [--] {module} {jar-
file}
DESCRIPTION
Imports the given <jar-file> using the module name and version given by
<module> into the repository named by the --out option.
<module> is a module name and version separated with a slash, for exam‐
ple com.example.foobar/1.2.0.
<jar-file> is the name of the Jar file to import.
OPTIONS
--cacherep=url
Specifies the folder to use for caching downloaded modules. (de‐
fault: ~/.ceylon/cache)
--cwd=dir
Specifies the current working directory for this tool. (default:
the directory where the tool is run from)
--descriptor=file
Specify a module.xml or module.properties file to be used as the
module descriptor
--dry-run
Performs all the sanity checks but does not publish the JAR.
--force
Skips sanity checks and forces publication of the JAR.
--maven-overrides=url
Specifies the xml file to use to load Maven artifact overrides.
See http://ceylon-lang.org/documentation/current/refer‐
ence/repository/maven/ for information. Deprecated: use --over‐
rides.
--no-default-repositories
Indicates that the default repositories should not be used.
--offline, -L
Enables offline mode that will prevent connections to remote
repositories.
--out=url, -o url
Specifies the output module repository (which must be publish‐
able). (default: ./modules)
--overrides=url
Specifies the xml file to use to load module overrides. See
http://ceylon-lang.org/documentation/current/reference/reposito‐
ry/maven/ for information. Experimental.
--pass=secret
Sets the password for use with an authenticated output reposito‐
ry(no default).
--rep=url
Specifies a module repository containing dependencies. Can be
specified multiple times. (default: modules, ~/.ceylon/repo,
http://modules.ceylon-lang.org/repo/1)
--show-classes
Shows all external classes that are not declared as imports in‐
stead of their packages only.
--show-suggestions
Shows suggestions for modules based on missing package names
(this can take a long time).
--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).
--update-descriptor
Whenever possible will create or adjust the descriptor file with
the necessary definitions.
--user=name
Sets the user name for use with an authenticated output reposi‐
tory(no default).
--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.
DESCRIPTORS
When the import-jar tool analyses the <jar-file> and complains about
missing dependencies a module descriptor file should be provided. The
name of this file can be provided using the --descriptor option or,
when left out, the tool will look for <jar-file>.module.properties or
<jar-file>.module.xml.
The format of these .properties or .xml files is documented online:
http://www.ceylon-lang.org/documentation/1.1/reference/structure/mod‐
ule/#legacy_modules
If the option --update-descriptor is given the tool will try to update
the given descriptor file with the available information (for now this
only works for the .properties files). If the file didn't exist yet it
will be created.
REPOSITORIES
Repositories like those specified with the --rep or --out options can
be file paths, HTTP urls to remote servers or can be names of reposito‐
ries when prepended with a + symbol. These names refer to repositories
defined in the configuration file or can be any of the following prede‐
fined names +SYSTEM, +CACHE, +LOCAL, +USER or +REMOTE. For more infor‐
mation see http://ceylon-lang.org/documentation/1.0/reference/tool/con‐
fig
28 October 2015 ceylon import-jar(1)
