DragonFly On-Line Manual Pages

Search: Section:  

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
       example 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.
              (default: ~/.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/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.

       --out=url, -o url
              Specifies the output module repository (which must be
              publishable). (default: ./modules)

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

       --pass=secret
              Sets the password for use with an authenticated output
              repository(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
              instead 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
              repository(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/module/#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
       repositories when prepended with a + symbol. These names refer to
       repositories defined in the configuration file or can be any of the
       following predefined names +SYSTEM, +CACHE, +LOCAL, +USER or +REMOTE.
       For more information see http://ceylon-
       lang.org/documentation/1.0/reference/tool/config

                                28 October 2015           ceylon import-jar(1)

Search: Section: