appium 2.0.0-beta.9 → 2.0.0-rc.2

package/build/lib/cli/parser.js

@@ -1,155 +1,259 @@
 "use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getParser = getParser;
-exports.getDefaultServerArgs = getDefaultServerArgs;
-exports.default = void 0;
-
-require("source-map-support/register");
-
-var _path = _interopRequireDefault(require("path"));
-
-var _lodash = _interopRequireDefault(require("lodash"));
-
-var _argparse = require("argparse");
-
-var _args = require("./args");
-
-var _extensionConfig = require("../extension-config");
-
-var _utils = require("../utils");
-
-function makeDebugParser(parser) {
-  parser.exit = (status, message = undefined) => {
-    throw new Error(message);
-  };
-}
-
-function getParser(debug = false) {
-  const parser = new _argparse.ArgumentParser({
-    add_help: true,
-    description: 'A webdriver-compatible server for use with native and hybrid iOS and Android applications.',
-    prog: process.argv[1] ? _path.default.basename(process.argv[1]) : 'appium'
-  });
-
-  if (debug) {
-    makeDebugParser(parser);
-  }
-
-  parser.add_argument('-v', '--version', {
-    action: 'version',
-    version: require(_path.default.resolve(_utils.rootDir, 'package.json')).version
-  });
-  const subParsers = parser.add_subparsers({
-    dest: 'subcommand'
-  });
-  const serverArgs = addServerToParser(_args.sharedArgs, subParsers, debug);
-  parser.rawArgs = serverArgs;
-  addExtensionsToParser(_args.sharedArgs, subParsers, debug);
-  parser._parse_args = parser.parse_args.bind(parser);
-
-  parser.parse_args = function (args, namespace) {
-    if (_lodash.default.isUndefined(args)) {
-      args = [...process.argv.slice(2)];
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArgParser = exports.getParser = exports.EXTRA_ARGS = void 0;
+const support_1 = require("@appium/support");
+const argparse_1 = require("argparse");
+const lodash_1 = __importDefault(require("lodash"));
+const path_1 = __importDefault(require("path"));
+const constants_1 = require("../constants");
+const schema_1 = require("../schema");
+const config_1 = require("../config");
+const args_1 = require("./args");
+exports.EXTRA_ARGS = 'extraArgs';
+/**
+ * If the parsed args do not contain any of these values, then we
+ * will automatially inject the `server` subcommand.
+ */
+const NON_SERVER_ARGS = Object.freeze(new Set([constants_1.DRIVER_TYPE, constants_1.PLUGIN_TYPE, constants_1.SERVER_SUBCOMMAND, '-h', '--help', '-v', '--version']));
+const version = support_1.fs.readPackageJsonFrom(config_1.rootDir).version;
+/**
+ * A wrapper around `argparse`
+ *
+ * - Handles instantiation, configuration, and monkeypatching of an
+ *    `ArgumentParser` instance for Appium server and its extensions
+ * - Handles error conditions, messages, and exit behavior
+ */
+class ArgParser {
+    /**
+     * @param {boolean} [debug] - If true, throw instead of exit on error.
+     */
+    constructor(debug = false) {
+        const prog = process.argv[1] ? path_1.default.basename(process.argv[1]) : 'appium';
+        const parser = new argparse_1.ArgumentParser({
+            add_help: true,
+            description: 'A webdriver-compatible server that facilitates automation of web, mobile, and other types of apps across various platforms.',
+            prog,
+        });
+        ArgParser._patchExit(parser);
+        /**
+         * Program name (typically `appium`)
+         * @type {string}
+         */
+        this.prog = prog;
+        /**
+         * If `true`, throw an error on parse failure instead of printing help
+         * @type {boolean}
+         */
+        this.debug = debug;
+        /**
+         * Wrapped `ArgumentParser` instance
+         * @type {ArgumentParser}
+         */
+        this.parser = parser;
+        parser.add_argument('-v', '--version', {
+            action: 'version',
+            version,
+        });
+        const subParsers = parser.add_subparsers({ dest: 'subcommand' });
+        // add the 'server' subcommand, and store the raw arguments on the parser
+        // object as a way for other parts of the code to work with the arguments
+        // conceptually rather than just through argparse
+        const serverArgs = ArgParser._addServerToParser(subParsers);
+        this.rawArgs = serverArgs;
+        // add the 'driver' and 'plugin' subcommands
+        ArgParser._addExtensionCommandsToParser(subParsers);
+        // backwards compatibility / drop-in wrapper
+        /**
+         * @type {ArgParser['parseArgs']}
+         */
+        this.parse_args = this.parseArgs;
     }
-
-    if (!_lodash.default.includes([_extensionConfig.DRIVER_TYPE, _extensionConfig.PLUGIN_TYPE, 'server', '-h', '--help', '-v', '--version'], args[0])) {
-      args.splice(0, 0, 'server');
+    /**
+     * Parse arguments from the command line.
+     *
+     * If no subcommand is passed in, this method will inject the `server` subcommand.
+     *
+     * `ArgParser.prototype.parse_args` is an alias of this method.
+     * @template {import('appium/types').CliCommand} [Cmd=import('appium/types').CliCommandServer]
+     * @param {string[]} [args] - Array of arguments, ostensibly from `process.argv`. Gathers args from `process.argv` if not provided.
+     * @returns {import('appium/types').Args<Cmd>} - The parsed arguments
+     */
+    parseArgs(args = process.argv.slice(2)) {
+        if (!NON_SERVER_ARGS.has(args[0])) {
+            args.unshift(constants_1.SERVER_SUBCOMMAND);
+        }
+        try {
+            const parsed = this.parser.parse_known_args(args);
+            const [knownArgs, unknownArgs] = parsed;
+            // XXX: you'd think that argparse, when given an alias for a subcommand,
+            // would set this value to the original subcommand name, but it doesn't.
+            if (knownArgs?.driverCommand === 'ls') {
+                knownArgs.driverCommand = 'list';
+            }
+            else if (knownArgs?.pluginCommand === 'ls') {
+                knownArgs.pluginCommand = 'list';
+            }
+            if (unknownArgs?.length &&
+                (knownArgs.driverCommand === 'run' || knownArgs.pluginCommand === 'run')) {
+                return ArgParser._transformParsedArgs(knownArgs, unknownArgs);
+            }
+            else if (unknownArgs?.length) {
+                throw new Error(`[ERROR] Unrecognized arguments: ${unknownArgs.join(' ')}`);
+            }
+            return ArgParser._transformParsedArgs(knownArgs);
+        }
+        catch (err) {
+            if (this.debug) {
+                throw err;
+            }
+            // this isn't tested via unit tests (we use `debug: true`) so may escape coverage.
+            /* istanbul ignore next */
+            {
+                // eslint-disable-next-line no-console
+                console.error(); // need an extra space since argparse prints usage.
+                // eslint-disable-next-line no-console
+                console.error(err.message);
+                process.exit(1);
+            }
+        }
     }
-
-    return this._parse_args(args, namespace);
-  }.bind(parser);
-
-  return parser;
-}
-
-function addServerToParser(sharedArgs, subParsers, debug = false) {
-  const serverParser = subParsers.add_parser('server', {
-    add_help: true,
-    help: 'Run an Appium server'
-  });
-
-  if (debug) {
-    makeDebugParser(serverParser);
-  }
-
-  for (const [flagsOrNames, opts] of [...sharedArgs, ..._args.serverArgs]) {
-    serverParser.add_argument(...flagsOrNames, { ...opts
-    });
-  }
-
-  return _args.serverArgs;
-}
-
-function getDefaultServerArgs() {
-  let defaults = {};
-
-  for (let [, arg] of _args.serverArgs) {
-    defaults[arg.dest] = arg.default;
-  }
-
-  return defaults;
-}
-
-function addExtensionsToParser(sharedArgs, subParsers, debug = false) {
-  for (const type of [_extensionConfig.DRIVER_TYPE, _extensionConfig.PLUGIN_TYPE]) {
-    const extParser = subParsers.add_parser(type, {
-      add_help: true,
-      help: `Access the ${type} management CLI commands`
-    });
-
-    if (debug) {
-      makeDebugParser(extParser);
+    /**
+     * Given an object full of arguments as returned by `argparser.parse_args`,
+     * expand the ones for extensions into a nested object structure and rename
+     * keys to match the intended destination.
+     *
+     * E.g., `{'driver-foo-bar': baz}` becomes `{driver: {foo: {bar: 'baz'}}}`
+     * @param {object} args
+     * @param {string[]} [unknownArgs]
+     * @returns {object}
+     */
+    static _transformParsedArgs(args, unknownArgs = []) {
+        const result = lodash_1.default.reduce(args, (unpacked, value, key) => {
+            if (!lodash_1.default.isUndefined(value) && (0, schema_1.hasArgSpec)(key)) {
+                const { dest } = /** @type {import('../schema/arg-spec').ArgSpec} */ ((0, schema_1.getArgSpec)(key));
+                lodash_1.default.set(unpacked, dest, value);
+            }
+            else {
+                // this could be anything that _isn't_ a server arg
+                unpacked[key] = value;
+            }
+            return unpacked;
+        }, {});
+        result[exports.EXTRA_ARGS] = unknownArgs;
+        return result;
+    }
+    /**
+     * Patches the `exit()` method of the parser to throw an error, so we can handle it manually.
+     * @param {ArgumentParser} parser
+     */
+    static _patchExit(parser) {
+        parser.exit = (code, msg) => {
+            if (code) {
+                throw new Error(msg);
+            }
+            process.exit();
+        };
     }
-
-    const extSubParsers = extParser.add_subparsers({
-      dest: `${type}Command`
-    });
-    const parserSpecs = [{
-      command: 'list',
-      args: _args.extensionArgs[type].list,
-      help: `List available and installed ${type}s`
-    }, {
-      command: 'install',
-      args: _args.extensionArgs[type].install,
-      help: `Install a ${type}`
-    }, {
-      command: 'uninstall',
-      args: _args.extensionArgs[type].uninstall,
-      help: `Uninstall a ${type}`
-    }, {
-      command: 'update',
-      args: _args.extensionArgs[type].update,
-      help: `Update installed ${type}s to the latest version`
-    }];
-
-    for (const {
-      command,
-      args,
-      help
-    } of parserSpecs) {
-      const parser = extSubParsers.add_parser(command, {
-        help
-      });
-
-      if (debug) {
-        makeDebugParser(parser);
-      }
-
-      for (const [flagsOrNames, opts] of [...sharedArgs, ...args]) {
-        parser.add_argument(...flagsOrNames, { ...opts
+    /**
+     *
+     * @param {import('argparse').SubParser} subParser
+     * @returns {import('./args').ArgumentDefinitions}
+     */
+    static _addServerToParser(subParser) {
+        const serverParser = subParser.add_parser('server', {
+            add_help: true,
+            help: 'Run an Appium server',
         });
-      }
+        ArgParser._patchExit(serverParser);
+        const serverArgs = (0, args_1.getServerArgs)();
+        for (const [flagsOrNames, opts] of serverArgs) {
+            // TS doesn't like the spread operator here.
+            // @ts-ignore
+            serverParser.add_argument(...flagsOrNames, { ...opts });
+        }
+        return serverArgs;
+    }
+    /**
+     * Adds extension sub-sub-commands to `driver`/`plugin` subcommands
+     * @param {import('argparse').SubParser} subParsers
+     */
+    static _addExtensionCommandsToParser(subParsers) {
+        for (const type of /** @type {[DriverType, PluginType]} */ ([constants_1.DRIVER_TYPE, constants_1.PLUGIN_TYPE])) {
+            const extParser = subParsers.add_parser(type, {
+                add_help: true,
+                help: `Access the ${type} management CLI commands`,
+            });
+            ArgParser._patchExit(extParser);
+            const extSubParsers = extParser.add_subparsers({
+                dest: `${type}Command`,
+            });
+            const extensionArgs = (0, args_1.getExtensionArgs)();
+            /**
+             * @type { {command: import('appium/types').CliExtensionSubcommand, args: import('./args').ArgumentDefinitions, help: string, aliases?: import('argparse').SubArgumentParserOptions['aliases']}[] }
+             */
+            const parserSpecs = [
+                {
+                    command: 'list',
+                    args: extensionArgs[type].list,
+                    help: `List available and installed ${type}s`,
+                    aliases: ['ls'],
+                },
+                {
+                    command: 'install',
+                    args: extensionArgs[type].install,
+                    help: `Install a ${type}`,
+                },
+                {
+                    command: 'uninstall',
+                    args: extensionArgs[type].uninstall,
+                    help: `Uninstall a ${type}`,
+                },
+                {
+                    command: 'update',
+                    args: extensionArgs[type].update,
+                    help: `Update installed ${type}s to the latest version`,
+                },
+                {
+                    command: 'run',
+                    args: extensionArgs[type].run,
+                    help: `Run a script (defined inside the ${type}'s package.json under the ` +
+                        `“scripts” field inside the “appium” field) from an installed ${type}`,
+                },
+            ];
+            for (const { command, args, help, aliases } of parserSpecs) {
+                const parser = extSubParsers.add_parser(command, { help, aliases: aliases ?? [] });
+                ArgParser._patchExit(parser);
+                for (const [flagsOrNames, opts] of args) {
+                    // add_argument mutates params so make sure to send in copies instead
+                    if (flagsOrNames.length === 2) {
+                        parser.add_argument(flagsOrNames[0], flagsOrNames[1], { ...opts });
+                    }
+                    else {
+                        parser.add_argument(flagsOrNames[0], { ...opts });
+                    }
+                }
+            }
+        }
     }
-  }
 }
-
-var _default = getParser;
-exports.default = _default;require('source-map-support').install();
-
-
-//# sourceMappingURL=data:application/json;charset=utf8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbImxpYi9jbGkvcGFyc2VyLmpzIl0sIm5hbWVzIjpbIm1ha2VEZWJ1Z1BhcnNlciIsInBhcnNlciIsImV4aXQiLCJzdGF0dXMiLCJtZXNzYWdlIiwidW5kZWZpbmVkIiwiRXJyb3IiLCJnZXRQYXJzZXIiLCJkZWJ1ZyIsIkFyZ3VtZW50UGFyc2VyIiwiYWRkX2hlbHAiLCJkZXNjcmlwdGlvbiIsInByb2ciLCJwcm9jZXNzIiwiYXJndiIsInBhdGgiLCJiYXNlbmFtZSIsImFkZF9hcmd1bWVudCIsImFjdGlvbiIsInZlcnNpb24iLCJyZXF1aXJlIiwicmVzb2x2ZSIsInJvb3REaXIiLCJzdWJQYXJzZXJzIiwiYWRkX3N1YnBhcnNlcnMiLCJkZXN0Iiwic2VydmVyQXJncyIsImFkZFNlcnZlclRvUGFyc2VyIiwic2hhcmVkQXJncyIsInJhd0FyZ3MiLCJhZGRFeHRlbnNpb25zVG9QYXJzZXIiLCJfcGFyc2VfYXJncyIsInBhcnNlX2FyZ3MiLCJiaW5kIiwiYXJncyIsIm5hbWVzcGFjZSIsIl8iLCJpc1VuZGVmaW5lZCIsInNsaWNlIiwiaW5jbHVkZXMiLCJEUklWRVJfVFlQRSIsIlBMVUdJTl9UWVBFIiwic3BsaWNlIiwic2VydmVyUGFyc2VyIiwiYWRkX3BhcnNlciIsImhlbHAiLCJmbGFnc09yTmFtZXMiLCJvcHRzIiwiZ2V0RGVmYXVsdFNlcnZlckFyZ3MiLCJkZWZhdWx0cyIsImFyZyIsImRlZmF1bHQiLCJ0eXBlIiwiZXh0UGFyc2VyIiwiZXh0U3ViUGFyc2VycyIsInBhcnNlclNwZWNzIiwiY29tbWFuZCIsImV4dGVuc2lvbkFyZ3MiLCJsaXN0IiwiaW5zdGFsbCIsInVuaW5zdGFsbCIsInVwZGF0ZSJdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7OztBQUFBOztBQUNBOztBQUNBOztBQUNBOztBQUNBOztBQUNBOztBQUdBLFNBQVNBLGVBQVQsQ0FBMEJDLE1BQTFCLEVBQWtDO0FBQ2hDQSxFQUFBQSxNQUFNLENBQUNDLElBQVAsR0FBYyxDQUFDQyxNQUFE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RjtBQUNGOztlQUVjeEMsUyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCBwYXRoIGZyb20gJ3BhdGgnO1xuaW1wb3J0IF8gZnJvbSAnbG9kYXNoJztcbmltcG9ydCB7IEFyZ3VtZW50UGFyc2VyIH0gZnJvbSAnYXJncGFyc2UnO1xuaW1wb3J0IHsgc2hhcmVkQXJncywgc2VydmVyQXJncywgZXh0ZW5zaW9uQXJncyB9IGZyb20gJy4vYXJncyc7XG5pbXBvcnQgeyBEUklWRVJfVFlQRSwgUExVR0lOX1RZUEUgfSBmcm9tICcuLi9leHRlbnNpb24tY29uZmlnJztcbmltcG9ydCB7IHJvb3REaXIgfSBmcm9tICcuLi91dGlscyc7XG5cblxuZnVuY3Rpb24gbWFrZURlYnVnUGFyc2VyIChwYXJzZXIpIHtcbiAgcGFyc2VyLmV4aXQgPSAoc3RhdHVzLCBtZXNzYWdlID0gdW5kZWZpbmVkKSA9PiB7XG4gICAgdGhyb3cgbmV3IEVycm9yKG1lc3NhZ2UpO1xuICB9O1xufVxuXG5mdW5jdGlvbiBnZXRQYXJzZXIgKGRlYnVnID0gZmFsc2UpIHtcbiAgY29uc3QgcGFyc2VyID0gbmV3IEFyZ3VtZW50UGFyc2VyKHtcbiAgICBhZGRfaGVscDogdHJ1ZSxcbiAgICBkZXNjcmlwdGlvbjogJ0Egd2ViZHJpdmVyLWNvbXBhdGlibGUgc2VydmVyIGZvciB1c2Ugd2l0aCBuYXRpdmUgYW5kIGh5YnJpZCBpT1MgYW5kIEFuZHJvaWQgYXBwbGljYXRpb25zLicsXG4gICAgcHJvZzogcHJvY2Vzcy5hcmd2WzFdID8gcGF0aC5iYXNlbmFtZShwcm9jZXNzLmFyZ3ZbMV0pIDogJ2FwcGl1bScsXG4gIH0pO1xuICBpZiAoZGVidWcpIHtcbiAgICBtYWtlRGVidWdQYXJzZXIocGFyc2VyKTtcbiAgfVxuICBwYXJzZXIuYWRkX2FyZ3VtZW50KCctdicsICctLXZlcnNpb24nLCB7XG4gICAgYWN0aW9uOiAndmVyc2lvbicsXG4gICAgdmVyc2lvbjogcmVxdWlyZShwYXRoLnJlc29sdmUocm9vdERpciwgJ3BhY2thZ2UuanNvbicpKS52ZXJzaW9uXG4gIH0pO1xuICBjb25zdCBzdWJQYXJzZXJzID0gcGFyc2VyLmFkZF9zdWJwYXJzZXJzKHtkZXN0OiAnc3ViY29tbWFuZCd9KTtcblxuICAvLyBhZGQgdGhlICdzZXJ2ZXInIHN1YmNvbW1hbmQsIGFuZCBzdG9yZSB0aGUgcmF3IGFyZ3VtZW50cyBvbiB0aGUgcGFyc2VyXG4gIC8vIG9iamVjdCBhcyBhIHdheSBmb3Igb3RoZXIgcGFydHMgb2YgdGhlIGNvZGUgdG8gd29yayB3aXRoIHRoZSBhcmd1bWVudHNcbiAgLy8gY29uY2VwdHVhbGx5IHJhdGhlciB0aGFuIGp1c3QgdGhyb3VnaCBhcmdwYXJzZVxuICBjb25zdCBzZXJ2ZXJBcmdzID0gYWRkU2VydmVyVG9QYXJzZXIoc2hhcmVkQXJncywgc3ViUGFyc2VycywgZGVidWcpO1xuICBwYXJzZXIucmF3QXJncyA9IHNlcnZlckFyZ3M7XG5cbiAgLy8gYWRkIHRoZSAnZHJpdmVyJyBhbmQgJ3BsdWdpbicgc3ViY29tbWFuZHNcbiAgYWRkRXh0ZW5zaW9uc1RvUGFyc2VyKHNoYXJlZEFyZ3MsIHN1YlBhcnNlcnMsIGRlYnVnKTtcblxuICAvLyBtb2RpZnkgdGhlIHBhcnNlX2FyZ3MgZnVuY3Rpb24gdG8gaW5zZXJ0IHRoZSAnc2VydmVyJyBzdWJjb21tYW5kIGlmIHRoZVxuICAvLyB1c2VyIGhhc24ndCBzcGVjaWZpZWQgYSBzdWJjb21tYW5kIG9yIHRoZSBnbG9iYWwgaGVscCBjb21tYW5kXG4gIHBhcnNlci5fcGFyc2VfYXJncyA9IHBhcnNlci5wYXJzZV9hcmdzLmJpbmQocGFyc2VyKTtcbiAgcGFyc2VyLnBhcnNlX2FyZ3MgPSBmdW5jdGlvbiAoYXJncywgbmFtZXNwYWNlKSB7XG4gICAgaWYgKF8uaXNVbmRlZmluZWQoYXJncykpIHtcbiAgICAgIGFyZ3MgPSBbLi4ucHJvY2Vzcy5hcmd2LnNsaWNlKDIpXTtcbiAgICB9XG4gICAgaWYgKCFfLmluY2x1ZGVzKFtEUklWRVJfVFlQRSwgUExVR0lOX1RZUEUsICdzZXJ2ZXInLCAnLWgnLCAnLS1oZWxwJywgJy12JywgJy0tdmVyc2lvbiddLCBhcmdzWzBdKSkge1xuICAgICAgYXJncy5zcGxpY2UoMCwgMCwgJ3NlcnZlcicpO1xuICAgIH1cbiAgICByZXR1cm4gdGhpcy5fcGFyc2VfYXJncyhhcmdzLCBuYW1lc3BhY2UpO1xuICB9LmJpbmQocGFyc2VyKTtcbiAgcmV0dXJuIHBhcnNlcjtcbn1cblxuZnVuY3Rpb24gYWRkU2VydmVyVG9QYXJzZXIgKHNoYXJlZEFyZ3MsIHN1YlBhcnNlcnMsIGRlYnVnID0gZmFsc2UpIHtcbiAgY29uc3Qgc2VydmVyUGFyc2VyID0gc3ViUGFyc2Vycy5hZGRfcGFyc2VyKCdzZXJ2ZXInLCB7XG4gICAgYWRkX2hlbHA6IHRydWUsXG4gICAgaGVscDogJ1J1biBhbiBBcHBpdW0gc2VydmVyJyxcbiAgfSk7XG5cbiAgaWYgKGRlYnVnKSB7XG4gICAgbWFrZURlYnVnUGFyc2VyKHNlcnZlclBhcnNlcik7XG4gIH1cblxuICBmb3IgKGNvbnN0IFtmbGFnc09yTmFtZXMsIG9wdHNdIG9mIFsuLi5zaGFyZWRBcmdzLCAuLi5zZXJ2ZXJBcmdzXSkge1xuICAgIC8vIGFkZF9hcmd1bWVudCBtdXRhdGVzIGFyZ3VtZW50cyBzbyBtYWtlIGNvcGllc1xuICAgIHNlcnZlclBhcnNlci5hZGRfYXJndW1lbnQoLi4uZmxhZ3NPck5hbWVzLCB7Li4ub3B0c30pO1xuICB9XG5cbiAgcmV0dXJuIHNlcnZlckFyZ3M7XG59XG5cbmZ1bmN0aW9uIGdldERlZmF1bHRTZXJ2ZXJBcmdzICgpIHtcbiAgbGV0IGRlZmF1bHRzID0ge307XG4gIGZvciAobGV0IFssIGFyZ10gb2Ygc2VydmVyQXJncykge1xuICAgIGRlZmF1bHRzW2FyZy5kZXN0XSA9IGFyZy5kZWZhdWx0O1xuICB9XG4gIHJldHVybiBkZWZhdWx0cztcbn1cblxuZnVuY3Rpb24gYWRkRXh0ZW5zaW9uc1RvUGFyc2VyIChzaGFyZWRBcmdzLCBzdWJQYXJzZXJzLCBkZWJ1ZyA9IGZhbHNlKSB7XG4gIGZvciAoY29uc3QgdHlwZSBvZiBbRFJJVkVSX1RZUEUsIFBMVUdJTl9UWVBFXSkge1xuICAgIGNvbnN0IGV4dFBhcnNlciA9IHN1YlBhcnNlcnMuYWRkX3BhcnNlcih0eXBlLCB7XG4gICAgICBhZGRfaGVscDogdHJ1ZSxcbiAgICAgIGhlbHA6IGBBY2Nlc3MgdGhlICR7dHlwZX0gbWFuYWdlbWVudCBDTEkgY29tbWFuZHNgLFxuICAgIH0pO1xuICAgIGlmIChkZWJ1Zykge1xuICAgICAgbWFrZURlYnVnUGFyc2VyKGV4dFBhcnNlcik7XG4gICAgfVxuICAgIGNvbnN0IGV4dFN1YlBhcnNlcnMgPSBleHRQYXJzZXIuYWRkX3N1YnBhcnNlcnMoe1xuICAgICAgZGVzdDogYCR7dHlwZX1Db21tYW5kYCxcbiAgICB9KTtcbiAgICBjb25zdCBwYXJzZXJTcGVjcyA9IFtcbiAgICAgIHtjb21tYW5kOiAnbGlzdCcsIGFyZ3M6IGV4dGVuc2lvbkFyZ3NbdHlwZV0ubGlzdCxcbiAgICAgICBoZWxwOiBgTGlzdCBhdmFpbGFibGUgYW5kIGluc3RhbGxlZCAke3R5cGV9c2B9LFxuICAgICAge2NvbW1hbmQ6ICdpbnN0YWxsJywgYXJnczogZXh0ZW5zaW9uQXJnc1t0eXBlXS5pbnN0YWxsLFxuICAgICAgIGhlbHA6IGBJbnN0YWxsIGEgJHt0eXBlfWB9LFxuICAgICAge2NvbW1hbmQ6ICd1bmluc3RhbGwnLCBhcmdzOiBleHRlbnNpb25BcmdzW3R5cGVdLnVuaW5zdGFsbCxcbiAgICAgICBoZWxwOiBgVW5pbnN0YWxsIGEgJHt0eXBlfWB9LFxuICAgICAge2NvbW1hbmQ6ICd1cGRhdGUnLCBhcmdzOiBleHRlbnNpb25BcmdzW3R5cGVdLnVwZGF0ZSxcbiAgICAgICBoZWxwOiBgVXBkYXRlIGluc3RhbGxlZCAke3R5cGV9cyB0byB0aGUgbGF0ZXN0IHZlcnNpb25gfSxcbiAgICBdO1xuXG4gICAgZm9yIChjb25zdCB7Y29tbWFuZCwgYXJncywgaGVscH0gb2YgcGFyc2VyU3BlY3MpIHtcbiAgICAgIGNvbnN0IHBhcnNlciA9IGV4dFN1YlBhcnNlcnMuYWRkX3BhcnNlcihjb21tYW5kLCB7aGVscH0pO1xuICAgICAgaWYgKGRlYnVnKSB7XG4gICAgICAgIG1ha2VEZWJ1Z1BhcnNlcihwYXJzZXIpO1xuICAgICAgfVxuICAgICAgZm9yIChjb25zdCBbZmxhZ3NPck5hbWVzLCBvcHRzXSBvZiBbLi4uc2hhcmVkQXJncywgLi4uYXJnc10pIHtcbiAgICAgICAgLy8gYWRkX2FyZ3VtZW50IG11dGF0ZXMgcGFyYW1zIHNvIG1ha2Ugc3VyZSB0byBzZW5kIGluIGNvcGllcyBpbnN0ZWFkXG4gICAgICAgIHBhcnNlci5hZGRfYXJndW1lbnQoLi4uZmxhZ3NPck5hbWVzLCB7Li4ub3B0c30pO1xuICAgICAgfVxuICAgIH1cbiAgfVxufVxuXG5leHBvcnQgZGVmYXVsdCBnZXRQYXJzZXI7XG5leHBvcnQgeyBnZXRQYXJzZXIsIGdldERlZmF1bHRTZXJ2ZXJBcmdzIH07XG4iXSwiZmlsZSI6ImxpYi9jbGkvcGFyc2VyLmpzIiwic291cmNlUm9vdCI6Ii4uLy4uLy4uIn0=
+exports.ArgParser = ArgParser;
+/**
+ * Creates a {@link ArgParser} instance; finalizes the config schema.
+ *
+ * @constructs ArgParser
+ * @param {boolean} [debug] - If `true`, throw instead of exit upon parsing error
+ * @returns {ArgParser}
+ */
+function getParser(debug) {
+    (0, schema_1.finalizeSchema)();
+    return new ArgParser(debug);
+}
+exports.getParser = getParser;
+/**
+ * @typedef {import('@appium/types').DriverType} DriverType
+ * @typedef {import('@appium/types').PluginType} PluginType
+ */
+//# sourceMappingURL=parser.js.map

package/build/lib/cli/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../lib/cli/parser.js"],"names":[],"mappings":"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"}

package/build/lib/cli/plugin-command.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @extends {ExtensionCliCommand<PluginType>}
+ */
+export default class PluginCliCommand extends ExtensionCliCommand<"plugin"> {
+    /**
+     *
+     * @param {import('./extension-command').ExtensionCommandOptions<PluginType>} opts
+     */
+    constructor({ config, json }: import('./extension-command').ExtensionCommandOptions<PluginType>);
+    /**
+     * Install a plugin
+     *
+     * @param {PluginInstallOpts} opts
+     * @returns {Promise<ExtRecord<PluginType>>}
+     */
+    install({ plugin, installType, packageName }: PluginInstallOpts): Promise<ExtRecord<PluginType>>;
+    /**
+     * Uninstall a plugin
+     *
+     * @param {PluginUninstallOpts} opts
+     * @returns {Promise<ExtRecord<PluginType>>}
+     */
+    uninstall({ plugin }: PluginUninstallOpts): Promise<ExtRecord<PluginType>>;
+    /**
+     * Update a plugin
+     *
+     * @param {PluginUpdateOpts} opts
+     * @returns {Promise<import('./extension-command').ExtensionUpdateResult>}
+     */
+    update({ plugin, unsafe }: PluginUpdateOpts): Promise<import('./extension-command').ExtensionUpdateResult>;
+    /**
+     *
+     * @param {PluginRunOptions} opts
+     * @returns {Promise<import('./extension-command').RunOutput>}
+     */
+    run({ plugin, scriptName, extraArgs }: PluginRunOptions): Promise<import('./extension-command').RunOutput>;
+}
+export type ExtensionType = import('@appium/types').ExtensionType;
+export type PluginType = import('@appium/types').PluginType;
+export type ExtRecord<ExtType extends import("@appium/types").ExtensionType> = import('appium/types').ExtRecord<ExtType>;
+/**
+ * Options for {@linkcode PluginCliCommand.install }
+ */
+export type PluginInstallOpts = {
+    /**
+     * - the name or spec of a plugin to install
+     */
+    plugin: string;
+    /**
+     * - how to install this plugin. One of the INSTALL_TYPES
+     */
+    installType: InstallType;
+    /**
+     * - for git/github installs, the plugin node package name
+     */
+    packageName?: string | undefined;
+};
+export type InstallType = import('appium/types').InstallType;
+/**
+ * Options for {@linkcode PluginCliCommand.uninstall }
+ */
+export type PluginUninstallOpts = {
+    /**
+     * - the name or spec of a plugin to uninstall
+     */
+    plugin: string;
+};
+/**
+ * Options for {@linkcode PluginCliCommand.update }
+ */
+export type PluginUpdateOpts = {
+    /**
+     * - the name of the plugin to update
+     */
+    plugin: string;
+    /**
+     * - if true, will perform unsafe updates past major revision boundaries
+     */
+    unsafe: boolean;
+};
+/**
+ * Options for {@linkcode PluginCliCommand.run }.
+ */
+export type PluginRunOptions = {
+    /**
+     * - name of the plugin to run a script from
+     */
+    plugin: string;
+    /**
+     * - name of the script to run
+     */
+    scriptName: string;
+    /**
+     * - arguments to pass to the script
+     */
+    extraArgs?: string[] | undefined;
+};
+import ExtensionCliCommand from "./extension-command";
+//# sourceMappingURL=plugin-command.d.ts.map

package/build/lib/cli/plugin-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-command.d.ts","sourceRoot":"","sources":["../../../lib/cli/plugin-command.js"],"names":[],"mappings":"AAMA;;GAEG;AACH;IACE;;;OAGG;IACH,8BAFW,OAAO,qBAAqB,EAAE,uBAAuB,CAAC,UAAU,CAAC,EAK3E;IAED;;;;;OAKG;IACH,8CAHW,iBAAiB,GACf,QAAQ,UAAU,UAAU,CAAC,CAAC,CAQ1C;IAED;;;;;OAKG;IACH,sBAHW,mBAAmB,GACjB,QAAQ,UAAU,UAAU,CAAC,CAAC,CAI1C;IAED;;;;;OAKG;IACH,2BAHW,gBAAgB,GACd,QAAQ,OAAO,qBAAqB,EAAE,qBAAqB,CAAC,CAIxE;IAED;;;;OAIG;IACH,uCAHW,gBAAgB,GACd,QAAQ,OAAO,qBAAqB,EAAE,SAAS,CAAC,CAS5D;CAkCF;4BAGY,OAAO,eAAe,EAAE,aAAa;yBACrC,OAAO,eAAe,EAAE,UAAU;+EAKlC,OAAO,cAAc,EAAE,SAAS,CAAC,OAAO,CAAC;;;;;;;;YAMxC,MAAM;;;;iBACN,WAAW;;;;;;0BAKZ,OAAO,cAAc,EAAE,WAAW;;;;;;;;YAMjC,MAAM;;;;;;;;;YAMN,MAAM;;;;YACN,OAAO;;;;;;;;;YAMP,MAAM;;;;gBACN,MAAM"}