Add raw REST API calls to MaxCtrl

Being able to perform raw REST API calls that leverage the value
extraction capabilities of Node.js gives more control to the end user. It
also doubles as a handy tool for creating scripts that only require one
particular value from the REST API.

maxctrl/lib/api.js

@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2016 MariaDB Corporation Ab
+ *
+ * Use of this software is governed by the Business Source License included
+ * in the LICENSE.TXT file and at www.mariadb.com/bsl11.
+ *
+ * Change Date: 2020-01-01
+ *
+ * On the date above, in accordance with the Business Source License, use
+ * of this software will be governed by version 2 or later of the General
+ * Public License.
+ */
+require('./common.js')()
+
+exports.command = 'api <command>'
+exports.desc = 'Raw REST API access'
+exports.handler = function() {}
+exports.builder = function(yargs) {
+    yargs
+        .command('get <resource> [path]', 'Get raw JSON', function(yargs) {
+            return yargs.epilog('Perform a raw REST API call. ' +
+                                'The path definition uses JavaScript syntax to extract values.')
+                .usage('Usage: get <resource> [path]')
+        }, function(argv) {
+            maxctrl(argv, function(host) {
+                return doRequest(host, argv.resource, (res) => {
+                    if (argv.path) {
+                        res = _.getPath(res, argv.path, '')
+                    }
+
+                    return JSON.stringify(res)
+                })
+            })
+        })
+        .usage('Usage: api <command>')
+        .help()
+        .command('*', 'the default command', {}, function(argv) {
+            maxctrl(argv, function(host) {
+                return error('Unknown command. See output of `help api` for a list of commands.')
+            })
+        })
+}

maxctrl/lib/core.js

@@ -100,6 +100,7 @@ program
     .command(require('./rotate.js'))
     .command(require('./call.js'))
     .command(require('./cluster.js'))
+    .command(require('./api.js'))
     .help()
     .demandCommand(1, 'At least one command is required')
     .command('*', 'the default command', {}, function(argv) {