@qiwi/nexus-cli v2.5.0

@qiwi/nexus-cli

CLI for managing Nexus NPM repository contents. Deletes and downloads package components.

Installation

You can use this utility without installation, see Usage

yarn add @qiwi/nexus-cli

or

npm i @qiwi/nexus-cli

Usage

You can call this utility without installing:

npx @qiwi/nexus-cli <arguments>

Delete

nexus-cli --auth.username foo --auth.password bar --url baz --data.repo npm --data.name bat --data.group quz --data.range '<2.0.3' --action delete

Download

For this action utility saves tarballs and prints metadata in given cwd

nexus-cli --auth.username foo --auth.password bar --url baz --data.repo npm --data.name foo --data.group qiwi --data.range '<1.0.0' --data.cwd nexus-downloads --action download

Output in nexus-downloads/nexus-cli-downloads-meta-2021-03-17T06:48:21.347Z.json:

[
	{
		"name": " @qiwi/foo",
		"version": "0.2.0",
		"filePath": "/Users/user/projects/platform/nexus/packages/cli/nexus-cli-downloads-2021-03-17T06:48:21.347Z/@qiwi%foo%2F-%foo-0.2.0.tgz"
	},
	{
		"name": " @qiwi/foo",
		"version": "0.6.0",
		"filePath": "/Users/user/projects/platform/nexus/packages/cli/nexus-cli-downloads-2021-03-17T06:48:21.347Z/@qiwi%foo%2F-%foo-0.6.0.tgz"
	}
]

Compare

Options for this action should be given via config

nexus-cli --config compare-config.json

Utility will write list of missing packages and list of extra packages for primary registry in comparison with secondary one.

Output in ${cwd}/missing.json

[
  {
    "group": "null",
    "name": "buildstamp",
    "version": "1.0.2"
  },
  {
    "group": "null",
    "name": "buildstamp",
    "version": "1.2.2"
  },
  {
    "group": "null",
    "name": "buildstamp",
    "version": "1.3.0"
  }
]

Output in ${cwd}/extra.json

[
  {
    "group": "null",
    "name": "buildstamp",
    "version": "1.0.1",
  }
]

With config file:

nexus-cli --config some/path/config.json

With config file and overriding

nexus-cli --config some/path/config.json --data.repo npm --data.name bat --data.group quz --data.range '<2.0.3'

Options

Common

By default batch.rateLimit is 3 requests per 1000 ms

Delete

Download

Compare

All options except --no-prompt must be set through the CLI flags or --config JSON data. Options from config file can be overridden. If you want to use --no-prompt option in a config file, add it as "prompt": false.

Config file

Delete

{
    "url": "http://localhost",
    "auth": {
        "username": "foo",
        "password": "bar"
    },
    "action": "delete",
    "package": {
        "group": "qiwi",
        "name": "substrate",
        "range": ">1.2.0",
        "repo": "npm"
    }
}

Download

{
    "url": "http://localhost",
    "auth": {
        "username": "foo",
        "password": "bar"
    },
    "action": "download",
    "package": {
        "group": "qiwi",
        "name": "substrate",
        "range": ">1.2.0",
        "repo": "npm",
        "cwd": "nexus-downloads",
        "npmBatch": {
            "access": "public"
        }
    }
}

Compare

{
  "action": "compare",
  "data": {
    "cwd": "temp-compare",
    "primaryRegistry": {
      "url": "http://foo.qiwi.com:8081/repository/npm-foo",
      "auth": {
        "username": "username",
        "password": "password"
      }
    },
    "secondaryRegistry": {
      "url": "https://bar.qiwi.com/repository/npm-foo",
      "auth": {
        "username": "username",
        "password": "password"
      }
    },
    "packages": [
      {
        "name": "baz",
        "group": "qiwi-bar"
      },
      {
        "name": "foo-bar",
        "group": "qiwi"
      },
      {
        "name": "common",
        "group": "null"
      }
    ]
  }
}