add

The add command is a utility for plugin authors; project dependencies are resolved automatically at build time so there is no need to manually add dependencies for a project.

Plugins are installed into a directory specific to the current release version; for example if you are using uwe@1.0.0 the installation directory for plugins would be:

$HOME/.uwe/releases/1.0.0/plugins

Plugins can be added from the registry, a local folder, an archive or a github repository; when a plugin is installed from an archive it must have been created using the pack command.

Install a plugin from the registry:

upm add std::core

Install a specific plugin version from the registry:

upm add std::core@4.1.12

Usage

upm-add 0.48.15
Add a plugin

The target plugin will be installed if it does not exist; if the plugin already exists use the --force option to
overwrite it.

Options --path, --archive, --git and <plugin-name> are mutually exclusive; it is an error to combine them.

USAGE:
    upm add [FLAGS] [OPTIONS] [plugin-name]

FLAGS:
    -f, --force      Force overwrite existing plugin
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -a, --archive <archive>    Path to a plugin archive
    -g, --git <git>            URL for a git repository
    -p, --path <path>          Path to a plugin folder
        --prefix <prefix>      Folder prefix for git repositories

ARGS:
    <plugin-name>    Plugin name

EXAMPLES:
    Add from the registry:
        upm add std::core
    Add a specific version from the registry:
        upm add std::core@4.1.12
    Add from a folder:
        upm add --path /path/to/plugin
    Add from an archive:
        upm add --archive /path/to/plugin/package.tar.xz
    Add from a git repository:
        upm add --git https://github.com/username/plugin-repo

Back to upm