@toa.io/cli 0.2.0-dev.3 → 0.2.1-dev.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/cli",
-  "version": "0.2.0-dev.3+8334154",
+  "version": "0.2.1-dev.1",
   "description": "Toa CLI",
   "author": "temich <tema.gurtovoy@gmail.com>",
   "homepage": "https://github.com/toa-io/toa#readme",
@@ -19,8 +19,14 @@
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
   "dependencies": {
+    "@toa.io/console": "*",
+    "@toa.io/generic": "*",
+    "@toa.io/kubernetes": "*",
+    "@toa.io/norm": "*",
+    "@toa.io/runtime": "*",
+    "@toa.io/yaml": "*",
     "find-up": "5.0.0",
-    "yargs": "17.2.1"
+    "yargs": "17.6.2"
   },
-  "gitHead": "8334154c1b8a8268ad90adfb15b43a876459014f"
+  "gitHead": "2be07592325b2e4dc823e81d882a4e50bf50de24"
 }

package/readme.md

@@ -0,0 +1,114 @@
+# Toa Command Line Interface
+
+## Development
+
+### configure
+
+Outputs shell commands to manipulate local environment variables, thus must be piped
+with `source /dev/stdin` to apply.
+
+<dl>
+<dt><code>toa configure &lt;key&gt; [value]</code></dt>
+<dd>
+Set Configuration Object key. Nested keys are addressed with dot notation.
+
+<code>--path</code> path to component (default <code>.</code>)<br/>
+<code>--reset</code> clear <code>key</code><br/>
+
+#### Examples
+
+It is assumed you are in the component's directory, use `--path` otherwise.
+
+```shell
+# set new value
+$ toa configure foo 'new value' | source /dev/stdin
+```
+
+```shell
+# clear key
+$ toa configure bar.baz --reset | source /dev/stdin
+```
+
+</dd>
+<dt><code>toa configure reset</code></dt>
+<dd>Remove Configuration Object.</dd>
+<dt><code>toa configure print</code></dt>
+<dd>Output Configuration Object as YAML.
+
+<code>--json</code> as JSON
+</dd>
+</dl>
+
+### replay
+
+[Replay](/extensions/sampling/docs/replay.md) samples. Reports in [TAP](https://testanything.org)
+format.
+
+<dl>
+<dt><code>toa replay [paths...]</code></dt>
+<dd>
+<code>paths</code> path(s) to component(s) or a context (default <code>.</code>)<br/>
+
+#### Examples
+
+```shell
+$ toa replay
+$ toa replay ./path/to/component
+$ toa replay ./components/a ./components/b
+$ toa replay ./components/*
+$ toa replay ./path/to/context
+```
+
+If path is a context directory (containing `context.toa.yaml` file), samples for components within
+the context will be found and replayed sequentially.
+
+</dd>
+</dl>
+
+## Exporting
+
+### export manifest
+
+<dl>
+<dt><code>toa export manifest</code></dt>
+<dd>Print normalized manifest.
+
+<code>--path</code> path to component (default <code>.</code>)<br/>
+<code>--error</code> print errors only<br/>
+</dd>
+</dl>
+
+## Deployment
+
+> Deployment commands use current `kubectl` context.
+
+### deploy
+
+<dl>
+<dt><code>toa deploy [environment]</code></dt>
+<dd>Deploy context.</dd>
+</dl>
+
+### conceal
+
+<dl>
+<dt>
+<code>toa conceal</code>
+<img src="https://img.shields.io/badge/Not_Implemented-red" alt="Not Implemented"/>
+</dt>
+<dd>Deploy new declared secrets.
+
+<code>--reset</code> don't skip already deployed</dd>
+
+<dt><code>toa conceal &lt;secret&gt; &lt;key&gt; &lt;value&gt;</code></dt>
+<dd>Deploy a <code>key</code> with a <code>value</code> to a <code>secret</code>.</dd>
+</dl>
+
+### reveal
+
+<dl>
+<dt>
+<code>toa reveal &lt;secret&gt;</code>
+</dt>
+<dd>Print keys and values of a secret.</dd>
+</dl>

package/src/commands/build.js

@@ -0,0 +1,23 @@
+'use strict'
+
+const { build } = require('../handlers/build')
+
+const builder = (yargs) => {
+  yargs
+    .positional('environment', {
+      type: 'string',
+      desc: 'Deployment environment'
+    })
+    .option('path', {
+      alias: 'p',
+      group: 'Command options:',
+      type: 'string',
+      desc: 'Path to context',
+      default: '.'
+    })
+}
+
+exports.command = 'build [environment]'
+exports.desc = 'Build and push docker images'
+exports.builder = builder
+exports.handler = build

package/src/commands/compose.js

@@ -1,3 +1,5 @@
+// noinspection JSCheckFunctionSignatures
+
 'use strict'
 
 const { compose } = require('../handlers/compose')
@@ -6,7 +8,7 @@ const builder = (yargs) => {
   yargs
     .positional('paths', {
       type: 'string',
-      desc: 'Path to package',
+      desc: 'Paths to components',
       default: '.'
     })
     .array('paths')
@@ -17,15 +19,14 @@ const builder = (yargs) => {
     })
     .array('bindings')
     .example([
-      ['$0 compose ./component', 'Path to component package'],
-      ['$0 compose ./first ./second', 'Paths enumeration'],
-      ['$0 compose ./components/**/', 'Glob pattern'],
-      ['$0 compose ./a/**/ ./b/**/', 'Glob patterns enumeration']
+      ['$0 compose ./component'],
+      ['$0 compose ./first ./second'],
+      ['$0 compose ./components/**/'],
+      ['$0 compose ./a/**/ ./b/**/']
     ])
-    .strictCommands()
 }
 
 exports.command = 'compose [paths...]'
-exports.desc = 'Start composition'
+exports.desc = 'Run composition'
 exports.builder = builder
 exports.handler = compose

package/src/commands/conceal.js

@@ -0,0 +1,21 @@
+'use strict'
+
+const { conceal } = require('../handlers/conceal')
+
+const builder = (yargs) => {
+  yargs
+    .positional('secret', {
+      type: 'string'
+    })
+    .positional('key', {
+      type: 'string'
+    })
+    .positional('value', {
+      type: 'string'
+    })
+}
+
+exports.command = 'conceal <secret> <key> <value>'
+exports.desc = 'Deploy a key with a value to a secret'
+exports.builder = builder
+exports.handler = conceal

package/src/commands/configure.js

@@ -0,0 +1,43 @@
+'use strict'
+
+const { configure } = require('../handlers/configure')
+
+const builder = (yargs) => {
+  yargs
+    .positional('key', {
+      type: 'string',
+      desc: 'Configuration Object key'
+    })
+    .positional('value', {
+      type: 'string',
+      desc: 'Key value'
+    })
+    .option('path', {
+      alias: 'p',
+      group: 'Command options:',
+      describe: 'Path to component',
+      type: 'string',
+      default: '.'
+    })
+    .option('reset', {
+      group: 'Command options:',
+      type: 'boolean',
+      desc: 'Remove Configuration Object key'
+    })
+    .option('json', {
+      group: 'Command options:',
+      type: 'boolean',
+      desc: 'Print as JSON'
+    })
+    .example([
+      ['$0 configure myKey \'new value\' | source /dev/stdin'],
+      ['$0 configure myObject.myKey --reset | source /dev/stdin'],
+      ['$0 configure reset | source /dev/stdin'],
+      ['$0 configure print --json']
+    ])
+}
+
+exports.command = 'configure [key] [value]'
+exports.desc = 'Output shell command to update local environment Configuration Object'
+exports.builder = builder
+exports.handler = configure

package/src/commands/deploy.js

@@ -4,24 +4,38 @@ const { deploy } = require('../handlers/deploy')
 
 const builder = (yargs) => {
   yargs
-    .positional('path', {
+    .positional('environment', {
+      type: 'string',
+      desc: 'Deployment environment'
+    })
+    .option('path', {
+      alias: 'p',
+      group: 'Command options:',
       type: 'string',
       desc: 'Path to context',
       default: '.'
     })
     .option('dry', {
+      alias: 'd',
+      group: 'Command options:',
       boolean: true,
       desc: 'Dry run'
     })
-    .option('no-wait', {
+    .option('namespace', {
+      alias: 'n',
+      group: 'Command options:',
+      type: 'string',
+      desc: 'Target namespace'
+    })
+    .option('wait', {
+      alias: 'w',
+      group: 'Command options:',
       boolean: true,
-      desc: 'Disable waiting for deployment ready state'
+      desc: 'Wait for deployment ready state'
     })
-    .usage('Usage: toa deploy /path/to/context')
-    .commandDir('./deploy')
 }
 
-exports.command = 'deploy [path]'
+exports.command = 'deploy [environment]'
 exports.desc = 'Deploy context'
 exports.builder = builder
 exports.handler = deploy

package/src/commands/export/deployment.js

@@ -0,0 +1,27 @@
+'use strict'
+
+const { dump } = require('../../handlers/export/deployment')
+
+const builder = (yargs) => {
+  yargs
+    .positional('target', {
+      type: 'string',
+      desc: 'Export target path'
+    })
+    .positional('environment', {
+      type: 'string',
+      desc: 'Deployment environment'
+    })
+    .option('path', {
+      alias: 'p',
+      group: 'Command options:',
+      type: 'string',
+      desc: 'Path to context',
+      default: '.'
+    })
+}
+
+exports.command = ['deployment <target> [environment]', 'dep']
+exports.desc = 'Export context deployment'
+exports.builder = builder
+exports.handler = dump

package/src/commands/export/images.js

@@ -0,0 +1,23 @@
+'use strict'
+
+const { prepare } = require('../../handlers/export/images')
+
+const builder = (yargs) => {
+  yargs
+    .positional('target', {
+      type: 'string',
+      desc: 'Export target path'
+    })
+    .option('path', {
+      alias: 'p',
+      group: 'Command options:',
+      type: 'string',
+      desc: 'Path to context',
+      default: '.'
+    })
+}
+
+exports.command = ['images [target]', 'imgs']
+exports.desc = 'Export docker image sources'
+exports.builder = builder
+exports.handler = prepare

package/src/commands/export/manifest.js

@@ -0,0 +1,25 @@
+'use strict'
+
+const { manifest } = require('../../handlers/export/manifest')
+
+const builder = (yargs) => {
+  yargs
+    .option('error', {
+      alias: 'e',
+      group: 'Command options:',
+      type: 'boolean',
+      desc: 'Print errors only'
+    })
+    .option('path', {
+      alias: 'p',
+      group: 'Command options:',
+      type: 'string',
+      desc: 'Path to component',
+      default: '.'
+    })
+}
+
+exports.command = ['manifest', 'man']
+exports.desc = 'Print manifest'
+exports.builder = builder
+exports.handler = manifest

package/src/commands/export.js

@@ -0,0 +1,9 @@
+'use strict'
+
+const builder = (yargs) => yargs
+  .commandDir('./export')
+  .demandCommand()
+
+exports.command = 'export <artifact>'
+exports.desc = 'Export internal artifacts'
+exports.builder = builder

package/src/commands/id.js

@@ -0,0 +1,7 @@
+'use strict'
+
+const { id } = require('../handlers/id')
+
+exports.command = 'id'
+exports.desc = false
+exports.handler = id

package/src/commands/invoke.js

@@ -10,9 +10,10 @@ const builder = (yargs) => {
     })
     .positional('request', {
       type: 'string',
-      desc: 'Request YAML'
+      desc: 'Request object (yaml)'
     })
     .option('path', {
+      alias: 'p',
       group: 'Command options:',
       type: 'string',
       describe: 'Path to component',

package/src/commands/replay.js

@@ -0,0 +1,19 @@
+// noinspection JSCheckFunctionSignatures
+
+'use strict'
+
+const { replay } = require('../handlers/replay')
+
+const builder = (yargs) => {
+  yargs
+    .positional('paths', {
+      type: 'string',
+      desc: 'Paths to components or context',
+      default: '.'
+    })
+}
+
+exports.command = 'replay [paths...]'
+exports.desc = 'Replay samples'
+exports.builder = builder
+exports.handler = replay

package/src/commands/reveal.js

@@ -0,0 +1,15 @@
+'use strict'
+
+const { reveal } = require('../handlers/reveal')
+
+const builder = (yargs) => {
+  yargs
+    .positional('secret', {
+      type: 'string'
+    })
+}
+
+exports.command = 'reveal <secret>'
+exports.desc = 'Print keys and values of a secret'
+exports.builder = builder
+exports.handler = reveal

package/src/commands/serve.js

@@ -0,0 +1,19 @@
+'use strict'
+
+const { serve } = require('../handlers/serve')
+
+const builder = (yargs) => {
+  yargs
+    .positional('path', {
+      alias: 'p',
+      group: 'Command options:',
+      type: 'string',
+      desc: 'Path to package',
+      default: '.'
+    })
+}
+
+exports.command = 'serve [path]'
+exports.desc = 'Run service'
+exports.builder = builder
+exports.handler = serve

package/src/handlers/.configure/subcommands.js

@@ -0,0 +1,15 @@
+'use strict'
+
+const { dump } = require('@toa.io/yaml')
+
+const reset = (provider) => console.log('unset ' + provider.key)
+
+const print = async (provider, argv) => {
+  await provider.connect()
+
+  const formatter = argv.json ? JSON.stringify : dump
+
+  console.log(formatter(provider.object))
+}
+
+exports.subcommands = { print, reset }

package/src/handlers/build.js

@@ -0,0 +1,14 @@
+'use strict'
+
+const boot = require('@toa.io/boot')
+
+const { context: find } = require('../util/find')
+
+const build = async (argv) => {
+  const path = find(argv.path)
+  const operator = await boot.deployment(path, argv.environment)
+
+  await operator.build()
+}
+
+exports.build = build

package/src/handlers/compose.js

@@ -2,13 +2,10 @@
 
 const boot = require('@toa.io/boot')
 
-const { manifest: find } = require('../util/find')
+const { components: find } = require('../util/find')
 
 async function compose (argv) {
   const paths = find(argv.paths)
-
-  if (paths === undefined) throw new Error(`No components found in ${argv.paths}`)
-
   const composition = await boot.composition(paths, argv)
 
   await composition.connect()

package/src/handlers/conceal.js

@@ -0,0 +1,11 @@
+'use strict'
+
+const { secrets } = require('@toa.io/kubernetes')
+
+const conceal = async (argv) => {
+  const { secret, key, value } = argv
+
+  await secrets.store(secret, { [key]: value })
+}
+
+exports.conceal = conceal

package/src/handlers/configure.js

@@ -0,0 +1,46 @@
+'use strict'
+
+const boot = require('@toa.io/boot')
+
+const { Factory } = require('@toa.io/extensions.configuration')
+
+const { subcommands } = require('./.configure/subcommands')
+const { components: find } = require('../util/find')
+
+async function configure (argv) {
+  const path = find(argv.path)
+  const manifest = await boot.manifest(path)
+  const factory = new Factory()
+  const provider = factory.provider(manifest)
+
+  if (argv.value === undefined && subcommands[argv.key] !== undefined) {
+    await subcommands[argv.key](provider, argv)
+
+    return
+  }
+
+  await provider.connect()
+
+  let key = argv.key
+  let value = argv.value
+
+  // :(
+  if (key !== undefined) {
+    if (value === undefined && key.includes('=')) [key, value] = key.split('=')
+
+    if (value === undefined) {
+      if (argv.reset !== true) throw new Error('Key value expected')
+      else provider.unset(key)
+    } else provider.set(key, value)
+  }
+
+  let command
+  const exported = provider.export()
+
+  if (exported === undefined) command = `unset ${provider.key}`
+  else command = `export ${provider.key}=` + exported
+
+  console.log(command)
+}
+
+exports.configure = configure

package/src/handlers/deploy.js

@@ -4,16 +4,30 @@ const boot = require('@toa.io/boot')
 
 const { context: find } = require('../util/find')
 
+/**
+ * @param {toa.cli.deploy.Arguments} argv
+ * @returns {Promise<void>}
+ */
 const deploy = async (argv) => {
   const path = find(argv.path)
-  const deployment = await boot.deployment(path)
+  const operator = await boot.deployment(path, argv.environment)
 
-  const options = {
-    wait: argv['no-wait'] !== true,
-    dry: argv.dry === true
-  }
+  if (argv.dry === true) {
+    const options = {}
+
+    if (argv.namespace !== undefined) options.namespace = argv.namespace
+
+    const output = await operator.template(options)
 
-  await deployment.install(options)
+    console.log(output)
+  } else {
+    const options = {}
+
+    if (argv.namespace !== undefined) options.namespace = argv.namespace
+    if (argv.wait === true) options.wait = true
+
+    await operator.install(options)
+  }
 }
 
 exports.deploy = deploy

package/src/handlers/export/deployment.js

@@ -0,0 +1,20 @@
+'use strict'
+
+const boot = require('@toa.io/boot')
+const { console } = require('@toa.io/console')
+
+const { context: find } = require('../../util/find')
+
+/**
+ * @param {{ path: string, target: string, environment?: string }} argv
+ * @returns {Promise<void>}
+ */
+const dump = async (argv) => {
+  const context = find(argv.path)
+  const operator = await boot.deployment(context, argv.environment)
+  const path = await operator.export(argv.target)
+
+  console.log(path)
+}
+
+exports.dump = dump

package/src/handlers/export/images.js

@@ -0,0 +1,16 @@
+'use strict'
+
+const boot = require('@toa.io/boot')
+const { console } = require('@toa.io/console')
+
+const { context: find } = require('../../util/find')
+
+const prepare = async (argv) => {
+  const context = find(argv.path)
+  const operator = await boot.deployment(context)
+  const path = await operator.prepare(argv.target)
+
+  console.log(path)
+}
+
+exports.prepare = prepare

package/src/handlers/export/manifest.js

@@ -0,0 +1,19 @@
+'use strict'
+
+const { component } = require('@toa.io/norm')
+const { dump } = require('@toa.io/yaml')
+const { console } = require('@toa.io/console')
+
+const { components: find } = require('../../util/find')
+
+const print = async (argv) => {
+  const path = find(argv.path)
+
+  if (path === undefined) throw new Error(`No component found in ${argv.path}`)
+
+  const manifest = await component(path)
+
+  if (argv.error !== true) console.log(dump(manifest))
+}
+
+exports.manifest = print

package/src/handlers/id.js

@@ -0,0 +1,11 @@
+'use strict'
+
+const { newid } = require('@toa.io/generic')
+
+const id = () => {
+  const id = newid()
+
+  console.log(id)
+}
+
+exports.id = id

package/src/handlers/invoke.js

@@ -1,26 +1,30 @@
 'use strict'
 
 const boot = require('@toa.io/boot')
-const { yaml } = require('@toa.io/gears')
-const { manifest: find } = require('../util/find')
+const yaml = require('@toa.io/yaml')
+const { components: find } = require('../util/find')
 
 async function invoke (argv) {
   const path = find(argv.path)
-  const request = yaml.parse(argv.request)
+  const request = argv.request ? yaml.parse(argv.request) : {}
 
-  const composition = await boot.composition([path], { bindings: null })
+  const composition = await boot.composition([path])
   await composition.connect()
 
   const manifest = await boot.manifest(path)
   const remote = await boot.remote(manifest.locator, manifest)
   await remote.connect()
 
-  const reply = await remote.invoke(argv.operation, request)
+  let reply
 
-  await remote.disconnect()
-  await composition.disconnect()
+  try {
+    reply = await remote.invoke(argv.operation, request)
+  } finally {
+    await remote.disconnect()
+    await composition.disconnect()
+  }
 
-  console.dir(reply)
+  if (reply !== undefined) console.log(reply)
 }
 
 exports.invoke = invoke

package/src/handlers/replay.js

@@ -0,0 +1,35 @@
+'use strict'
+
+const find = require('../util/find')
+
+async function replay (argv) {
+  // prevent loading userland which is intended for local use only
+  const { context, components } = require('@toa.io/userland/samples')
+
+  /** @type {boolean} */
+  let ok
+
+  const paths = find.components(argv.paths, true)
+
+  if (paths !== null) {
+    ok = await components(paths)
+  } else {
+    // no components found, checking context
+    const path = find.context(argv.paths[0], true)
+
+    if (path === null) throw new Error('Neither components nor context found in ' + argv.paths.join(','))
+
+    ok = await context(path)
+  }
+
+  const message = (ok ? GREEN + 'PASSED' : RED + 'FAILED') + RESET
+
+  // print after tap's output
+  process.on('beforeExit', () => console.log(message))
+}
+
+const GREEN = '\x1b[32m'
+const RED = '\x1b[31m'
+const RESET = '\x1b[0m'
+
+exports.replay = replay

package/src/handlers/reveal.js

@@ -0,0 +1,17 @@
+'use strict'
+
+const { secrets } = require('@toa.io/kubernetes')
+const { remap, decode } = require('@toa.io/generic')
+
+const reveal = async (argv) => {
+  const secret = await secrets.get(argv.secret)
+  const values = remap(secret.data, decode)
+
+  for (const [key, value] of Object.entries(values)) {
+    const line = `${key}: ${value}`
+
+    console.log(line)
+  }
+}
+
+exports.reveal = reveal

package/src/handlers/serve.js

@@ -0,0 +1,28 @@
+'use strict'
+
+const boot = require('@toa.io/boot')
+const { shortcuts } = require('@toa.io/norm')
+const { directory: { find } } = require('@toa.io/filesystem')
+
+const serve = async (argv) => {
+  argv.path = shortcuts.resolve(argv.path)
+
+  const module = find(argv.path, process.cwd())
+
+  const { Factory } = require(module)
+
+  /** @type {toa.core.extensions.Factory} */
+  const factory = new Factory(boot)
+
+  /** @type {toa.core.Connector} */
+  const service = factory.service()
+
+  if (service === undefined) throw new Error(`Cannot find service '${argv.name}' in ${argv.path}`)
+
+  await service.connect()
+
+  // for tests
+  return service
+}
+
+exports.serve = serve

package/src/program.js

@@ -1,28 +1,29 @@
+// noinspection JSUnresolvedVariable
+
 'use strict'
 
 const yargs = require('yargs/yargs')
 
-const { console } = require('@toa.io/gears')
-const { version } = require('../package.json')
+const { console } = require('@toa.io/console')
+const { version } = require('@toa.io/runtime')
 
 yargs(process.argv.slice(2))
   .parserConfiguration({
     'boolean-negation': false
   })
   .middleware((argv) => {
-    if (argv.log === undefined) argv.log = 'info'
+    if (argv.log === undefined) argv.log = process.env.TOA_DEBUG === '1' ? 'debug' : 'info'
 
     console.level(argv.log)
   })
   .fail((msg, err) => {
     const actual = err || new Error(msg)
 
-    console.error(process.env.TOA_ENV === 'local' ? actual : actual.message)
+    console.error(process.env.TOA_DEBUG === '1' ? actual : actual.message)
 
     process.exit(actual.exitCode > 0 ? actual.exitCode : 1)
   })
   .option('log', {
-    type: 'string',
     describe: 'Log level'
   })
   .commandDir('./commands')

package/src/util/args.js

@@ -8,7 +8,7 @@ const bindings = (argv) => {
   if (argv.bindings !== undefined) {
     bindings = argv.bindings.map((binding) => {
       if (binding[0] === '@' && binding.indexOf('/') === -1) {
-        binding = '@toa.io/bindings.' + binding.substr(1)
+        binding = '@toa.io/bindings.' + binding.substring(1)
       }
 
       return binding

package/src/util/find.js

@@ -3,25 +3,53 @@
 const { dirname, resolve } = require('node:path')
 const findUp = require('find-up')
 
-const find = (from = '.', filename) => {
+/**
+ * @param {string | string[]} from
+ * @param {string} filename
+ * @param {boolean} test
+ * @return {string | string[] | null}
+ */
+const find = (from, filename, test) => {
   if (from instanceof Array) {
-    const found = new Set(from.map((path) => find(path, filename)))
+    const found = new Set(from.map((path) => find(path, filename, true)))
 
-    found.delete(undefined)
+    found.delete(null)
 
-    return found.size > 0 ? [...found] : undefined
+    if (found.size === 0) {
+      if (test === true) return null
+      else throw new Error(`File '${filename}' is found in ${from.join(', ')}`)
+    }
+
+    return [...found]
   }
 
-  const path = findUp.sync(filename, { cwd: resolve(process.cwd(), from) })
+  const cwd = resolve(process.cwd(), from)
+  const path = findUp.sync(filename, { cwd })
+
+  if (path === undefined) {
+    if (test === true) return null
+    else throw new Error(`Cannot find '${filename}' from '${from}'`)
+  }
 
-  return path === undefined ? undefined : dirname(path)
+  return dirname(path)
 }
 
-const manifest = (from = '.') => find(from, MANIFEST)
-const context = (from = '.') => find(from, CONTEXT)
+/**
+ * @param {string | string[]} from
+ * @param {boolean} test
+ * @return {string | string[] | null}
+ */
+const components = (from, test = false) => find(from, MANIFEST, test)
+
+/**
+ * @param {string | string[]} from
+ * @param {boolean} test
+ * @return {string | string[] | null}
+ */
+const context = (from, test = false) => find(from, CONTEXT, test)
 
 const MANIFEST = 'manifest.toa.yaml'
 const CONTEXT = 'context.toa.yaml'
 
-exports.manifest = manifest
+exports.components = components
 exports.context = context

package/types/deploy.d.ts

@@ -0,0 +1,10 @@
+declare namespace toa.cli.deploy {
+
+    interface Arguments {
+        path: string
+        environment?: string
+        namespace?: string
+        dry: boolean
+        wait: boolean
+    }
+}

package/LICENSE

@@ -1,22 +0,0 @@
-Copyright (c) 2020-present Artem Gurtovoi
-
-MIT License
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/src/commands/deploy/export.js

@@ -1,22 +0,0 @@
-'use strict'
-
-const { dump } = require('../../handlers/deploy/export')
-
-const builder = (yargs) => {
-  yargs
-    .positional('path', {
-      type: 'string',
-      desc: 'Path to context',
-      default: '.'
-    })
-    .positional('target', {
-      type: 'string',
-      desc: 'Export target path'
-    })
-    .usage('Usage: toa deploy export /path/to/context /export/path')
-}
-
-exports.command = 'export [path] [target]'
-exports.desc = 'Export context deployment chart'
-exports.builder = builder
-exports.handler = dump

package/src/commands/manifest.js

@@ -1,18 +0,0 @@
-'use strict'
-
-const { manifest } = require('../handlers/manifest')
-
-const builder = (yargs) => {
-  yargs
-    .positional('path', {
-      type: 'string',
-      desc: 'Path to component',
-      default: '.'
-    })
-    .usage('Usage: toa manifest /path/to/component')
-}
-
-exports.command = 'manifest [path]'
-exports.desc = 'Print manifest'
-exports.builder = builder
-exports.handler = manifest

package/src/handlers/deploy/export.js

@@ -1,16 +0,0 @@
-'use strict'
-
-const boot = require('@toa.io/boot')
-const { console } = require('@toa.io/gears')
-
-const { context: find } = require('../../util/find')
-
-const dump = async (argv) => {
-  const context = find(argv.path)
-  const deployment = await boot.deployment(context)
-  const path = await deployment.export(argv.target)
-
-  console.log(path)
-}
-
-exports.dump = dump

package/src/handlers/manifest.js

@@ -1,14 +0,0 @@
-'use strict'
-
-const { manifest: load } = require('@toa.io/package')
-const { console, yaml } = require('@toa.io/gears')
-
-const { manifest: find } = require('../util/find')
-
-const print = async (argv) => {
-  const manifest = await load(find(argv.path))
-
-  console.log(yaml.dump(manifest))
-}
-
-exports.manifest = print