Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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] [--ignore-annotations] [--maven-
		       overrides=file] [--missing-dependency-packages=value...]
		       [--no-default-repositories] [--offline] [--out=url]
		       [--overrides=file] [--pass=secret] [--rep=url...]
		       [--show-classes] [--show-suggestions] [--sysrep=url]
		       [--timeout=seconds] [--update-descriptor] [--user=name]
		       [--verbose[=flags]] [--] {module} {jar-file} [source-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.

     <source-jar-file>	is an optional name of a Jar file containing the sources
     for 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.

     --ignore-annotations
	    Do not check annotations for imports (default: false).

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

     --missing-dependency-packages=value
	    Specifies which packages a missing dependency contains. Can be spec-
	    ified   multiple   times.  Format:	module-name/module-version=pack-
	    age-wildcard(,package-wildcard)*, where package-wildcard supports *,
	    ** and ? wildcards.

     --no-default-repositories
	    Indicates that the default repositories should not be used.

     --offline, -L
	    Enables offline mode that will prevent connections to remote reposi-
	    tories.

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

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

     --pass=secret
	    Sets the password for use with an  authenticated  output  repository
	    (no default).

     --rep=url
	    Specifies a module repository containing dependencies. Can be speci-
	    fied multiple times. (default: modules, ~/.ceylon/repo, https://mod-
	    ules.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. (de-
	    fault: $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  miss-
     ing  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>.mod-
     ule.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.

     If the option --source-jar-file is given the tool will try to  include  the
     source jar into the module as well, including a SHA1 of that source jar.

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, +REMOTE or +MAVEN. For more information see
     https://ceylon-lang.org/documentation/1.3/reference/repository/tools

				 18 August 2017 	    ceylon import-jar(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ceylon-import-jar&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help