package Command Group¤
List, (un)install, export, create, or inspect packages.
Packages bundle re-usable content such as projects or vocabularies together with a manifest, so that it can be distributed and installed in other deployments. Packages are identified by a PACKAGE_ID and are used either as a package directory, as a Corporate Memory Package Archive (.cpa), or from a marketplace.
Typical workflows are to install packages from a marketplace (package search and package install), and to create packages from your own workspace (package export, package build and package publish).
Note
To get a list of installed packages, execute the package list command or use tab-completion.
package inspect¤
Inspect the manifest of a package.
This command outputs the metadata of a package, taken from the manifest of a package archive (.cpa) or of an (extracted) package directory. Since the manifest is read from the given path, the package does not need to be installed in the workspace.
Without further options, all manifest keys and values are shown in a table. With the --key option, only the keys which start with the given value are shown; if this matches a single key, its plain value is output, which is useful for scripting. Use `--keyall` to output the complete manifest again.
package list¤
List installed packages.
Outputs a table of the packages which are currently installed in your Corporate Memory, with their ID, installed version, type and name. The package IDs can be used as a reference for the package uninstall and package export commands.
Note
In order to list the packages which are available on the marketplace but not necessarily installed, use the package search command instead.
Options
package install¤
Install packages.
This command installs a package either from the marketplace or from local package archives (.cpa) or package directories.
If a local package is chosen which has unzipped project directories, the installation will handle the zipping silently. See the package export command for more information.
Options
-i, --input PATH Install a package from a package archive (.cpa) or
directory.
--replace Replace (overwrite) an existing package version or
package content, if present.
--no-cache Disable using cached package versions.
--ignore-lock Ignore and release the package lock file for this
operation. Use this to recover from a stale lock
left by an interrupted run. Dangerous under
concurrent access (it removes the lock other
processes rely on); use with care.
--version TEXT Specific version to install from the marketplace.
Defaults to the latest version.
--marketplace-url TEXT Base URL of the Marketplace - uses environment
variable ECCENCA_MARKETPLACE_URL if available.
[default: https://eccenca.market]
package uninstall¤
Uninstall installed packages.
This command removes installed packages from Corporate Memory. The packages to uninstall are selected either by giving a package ID, by using the --filter option, or by using the --all flag.
By default, dependencies between packages are respected, so uninstalling a package which is still needed by another installed package will fail. With the --all flag, all packages are removed regardless of their dependencies.
Warning
Uninstalling a package removes the resources it provides from your Corporate Memory, so use this command with care.
Options
--ignore-lock Ignore and release the package lock file for this
operation. Use this to recover from a stale lock
left by an interrupted run. Dangerous under
concurrent access (it removes the lock other
processes rely on); use with care.
--filter <TEXT TEXT>... Filter installed packages by one of the following
filter names and a corresponding value: type, name,
id.
-a, --all Uninstall all packages. This is a dangerous option,
so use it with care.
package export¤
Export installed packages to package directories.
This command exports installed packages from Corporate Memory to the local file system. For each exported package, a directory named after the package ID is created in the output directory, holding the manifest and the exported package content. The packages to export are selected either by giving a package ID, by using the --filter option, or by using the --all flag.
With the --extract flag, the build project archives referenced in the manifest are unpacked into directories and the archives are removed. This results in a directory structure which is better suited for version control. Note that the manifest still references the project ZIP files, and that the package build and package install commands zip such directories again on the fly.
Options
--mime_type [text/turtle|text/turtle+pretty]
Choose the MIME type for graphs when
exporting packages. [default:
text/turtle+pretty]
--filter <TEXT TEXT>... Filter installed packages by one of the
following filter names and a corresponding
value: type, name, id.
-a, --all Export all installed packages.
--output-dir DIRECTORY Create package directories in this base
directory. [default: .]
--replace Replace (overwrite) existing files, if
present.
--extract Extract the project files specified in the
manifest and replace the archive with
itsextracted directory. This is useful for
version controlled package directories.
package build¤
Build a package archive from a package directory.
This command processes a package directory, validates its content including the manifest, and creates a versioned Corporate Memory Package Archive (.cpa) with the following naming convention: {package_id}-v{version}.cpa
If the package contains an extracted project (directory) instead of a ZIP, it is zipped automatically in a temporary copy — the original package directory is never modified. The manifest still need to reference the project ZIP. See the package export command for more information.
Note
Package archives can be published to the marketplace using the package publish command.
Options
package publish¤
Publish a package archive to the marketplace server.
This command uploads a Corporate Memory Package Archive (.cpa) to a marketplace server, so that it can be found with the package search command and installed with the package install command. Package archives are created with the package build command; the published package ID and version are taken from the manifest inside the archive.
Publishing requires a marketplace account. Account and password are given with the --marketplace-account and --marketplace-password options or with the corresponding environment variables, otherwise they are requested interactively.
Options
--timeout INTEGER Timeout for marketplace requests.
--marketplace-url TEXT Base URL of the Marketplace - uses environment
variable ECCENCA_MARKETPLACE_URL if available.
[default: https://eccenca.market]
--marketplace-account TEXT Marketplace account - uses environment variable
ECCENCA_MARKETPLACE_ACCOUNT if available.
--marketplace-password TEXT Marketplace password - uses environment
variable ECCENCA_MARKETPLACE_PASSWORD if
available.
package search¤
Search for available packages with a given search text.
This command fetches the list of packages which are available on the marketplace and outputs their ID, name, description and type. The package IDs can be used as a reference for the package install command.
Each search term is matched case-insensitively against the ID, name, description and type of package, and only packages which match all given terms are listed. Without any search term, all available packages are listed.
Note
In order to list the packages which are installed in your Corporate Memory, use the package list command instead.