Repository Plugin (quokka.plugin.repository:0.1, namespace=repo)

The Respository plugin provides targets for maintaining repositories

Main Targets

update-snapshots Updates snapshots to the latest version available from all repositories
resolve-dependencies Forces all project dependencies to be resolved, ensuring availability locally
list Lists the artifacts available in the repository

Minor Targets

copy Copies one or more artifacts from one repository to another
remove Removes one or more artifacts from a repository
install Installs a 3rd party artifact to a repository
rebuild-caches Rebuilds the repository caches

Template Targets

package Implements quokka.plugin.lifecycle:package
copy-path Copies artifacts defined in a project path to a given repository

update-snapshots

Updates snapshots to the latest version available from all repositories

  • alias: update-snapshots
  • prefix: q.repository.updateSnapshots

resolve-dependencies

Forces all project dependencies to be resolved, ensuring availability locally

  • alias: resolve-dependencies
  • prefix: q.repository.resolveDependencies

list

Lists the artifacts available in the repository

  • alias: list
  • prefix: q.repository.list

Properties:

All properties are optional unless stated otherwise.

  • repository: The name of the repository to list. Defaults to the project repository.
  • format: Either ids, short, or long. ids lists just the artifact ids; short lists the short description; long provides details on dependencies and licenses. The default is short unless id is specified, in which case it's long.
  • id: Filters the list to only ids that match the value given. The format is group:name:type:version - not all tokens need to be supplied.
  • includeReferenced: If true, artifacts available in parent repositories will be included, otherwise only artifacts stored in the named repository are listed. Defaults to true unless repository is specified in which case it is false.
  • output: Writes the listing to the given file instead of logging to the console.

Default Properties

format ${@setifdef format}
id ${@setifdef id}
includeReferenced ${@setifdef includeReferenced}
output ${@setifdef output}
repository ${@setifdef repository}

copy

Copies one or more artifacts from one repository to another

  • prefix: q.repository.copy

Properties:

  • from: Optional. The name of the repository to copy from. Defaults to the project repository.
  • to: Mandatory. The name of repository to copy to.
  • id or ids: One of them must be supplied. id should be a single id in group:name:type:version format. ids is a file containing 1 id per line.

Default Properties

from ${@setifdef from}
id ${@setifdef id}
ids ${@setifdef ids}
repository ${@setifdef repository}
to ${@setifdef to}

remove

Removes one or more artifacts from a repository

  • prefix: q.repository.remove

Properties:

  • from: Optional. The name of the repository to copy from. Defaults to the project repository.
  • id or ids: One of them must be supplied. id should be a single id in group:name:type:version format. ids is a file containing 1 id per line.

Default Properties

from ${@setifdef from}
id ${@setifdef id}
ids ${@setifdef ids}

install

Installs a 3rd party artifact to a repository

  • prefix: q.repository.install

Properties:

  • id: Mandatory. The id of the file to install in group:name:type:version format.
  • file: Mandatory. The file to install
  • to: Optional. The name of repository to copy to. Defaults to the project repository.

Default Properties

file ${@setifdef file}
id ${@setifdef id}
to ${@setifdef to}

rebuild-caches

Rebuilds the repository caches

  • prefix: q.repository.rebuildCaches

Default Properties

repository ${@setifdef repository}

package

  • template: true
  • Implements: quokka.plugin.lifecycle:package

Creates a repository bundle, a .jar file containing one or more artifacts.

Properties:

All properties are optional unless stated otherwise.

  • artifactName: The name of the artifact to create. Mandatory if >1 jar artifacts in project.
  • path: The id of the path that contains the artifacts to bundle. Mandatory if >1 jar artifacts in project, otherwise defaults to 'bundle'

Default Properties

artifactName ${q.project.artifact.name[jar]}

copy-path

Copies artifacts defined in a project path to a given repository

  • template: true

Properties:

  • path: Mandatory. The name of the project path to copy from.
  • to: Mandatory. The name of repository to copy to.

Plugin Paths

runtime : Runtime class path

quokka.core.metadata metadata 0.3

quokka.core.plugin-spi plugin-spi 0.3

quokka.core.util util 0.3

quokka.plugin.lifecycle lifecycle 0.3

quokka.core.plugin-spi plugin-spi 0.3

apache.ant ant 1.7.1

quokka.core.bootstrap-util bootstrap-util 0.3

quokka.core.repo-spi repo-spi 0.3

quokka.core.bootstrap-util bootstrap-util 0.3

apache.ant ant 1.7.1