tagger

Simple utility to do something (e.g. install) packages from git repository by selecting git tag which is presented by semver rules.

Tagger works with git repositories only through ssh connection.

If you have a package that is not in npm or local repos but it has versionong, tagger may be helpful for you.

Requirements

tagger works with:

• ~~macOS~~ // TODO
• Linux (64-bit)
• Windows (64-bit)

CLI

Usage: tagger (--help | --version)
       tagger [--cfg PATH] (--show-latest | --list-all) PACKAGES...
       tagger [--exec --cfg PATH] PACKAGES...

Options:
    -h, --help              Show this message.
    -v, --version           Show the version of tagger.
    -c PATH, --cfg PATH     Path to config file. If not specified config will be searching in ./.tagger.cfg.json and ~/.tagger.cfg.json"
    -l, --show-latest       Prints latest valid tag.
    -a, --list-all          Prints all valid by semver tags.
    -e, --exec              *optional. Do something with specified or latest package version.

Examples:
    tagger ui
    tagger --show-latest hlp
    tagger --exec -c ../path_to_tagger_config.json [email protected]

Config file

Config file name by default is .tagger.cfg.json. And if it is not specified, it is searched in directory where you run tagger or in your home directory (e.g. ~/.tagger.cfg.json).

Config includes fields:

repos

Type: Array<{name: string, url: string}>

List of package repositories you want to use. Each item in this list cantains name ( to identify it ) and url know how to connect. Example:

{
  "repos": [
    {
      "name": "tagger",
      "url": "ssh://[email protected]:emgyrz/tagger.git"
    }
  ],
  // ...
}

command

Type: String

Says what to do with package. In command you have several variables that will be replaced on executing

• {NAME} - name of package presents in repo
• {URL} - same
• {VERSION} - version of package you were specify or latest version

Example:

{
  // ...
  "command": "yarn add {URL}#{VERSION}"
  // "command": "echo 'my latest version of package {NAME} is {VERSION}'",
  // "command": "rm -rf / :)"
}

Enjoy using!

License

This package is MIT licensed.