homebridge-deconz 0.1.4 → 0.1.7

package/cli/deconz.js

@@ -9,11 +9,13 @@
 
 const fs = require('fs')
 const Deconz = require('../lib/Deconz')
-const homebridgeLib = require('homebridge-lib')
+const {
+  CommandLineParser, CommandLineTool, JsonFormatter, OptionParser
+} = require('hb-lib-tools')
 const packageJson = require('../package.json')
 
-const { b, u } = homebridgeLib.CommandLineTool
-const { UsageError } = homebridgeLib.CommandLineParser
+const { b, u } = CommandLineTool
+const { UsageError } = CommandLineParser
 
 const usage = {
   deconz: `${b('deconz')} [${b('-hVDp')}] [${b('-H')} ${u('hostname')}[${b(':')}${u('port')}]] [${b('-K')} ${u('api key')}] [${b('-t')} ${u('timeout')}] ${u('command')} [${u('argument')} ...]`,
@@ -351,7 +353,7 @@ Parameters:
   Print full API output.`
 }
 
-class Main extends homebridgeLib.CommandLineTool {
+class Main extends CommandLineTool {
   constructor () {
     super({ mode: 'command', debug: false })
     this.usage = usage.deconz
@@ -378,7 +380,7 @@ class Main extends homebridgeLib.CommandLineTool {
   }
 
   writeGateways () {
-    const jsonFormatter = new homebridgeLib.JsonFormatter(
+    const jsonFormatter = new JsonFormatter(
       { noWhiteSpace: true, sortKeys: true }
     )
     const text = jsonFormatter.stringify(this.gateways)
@@ -386,7 +388,7 @@ class Main extends homebridgeLib.CommandLineTool {
   }
 
   parseArguments () {
-    const parser = new homebridgeLib.CommandLineParser(packageJson)
+    const parser = new CommandLineParser(packageJson)
     const clargs = {
       options: {
         host: process.env.DECONZ_HOST || 'localhost',
@@ -397,11 +399,11 @@ class Main extends homebridgeLib.CommandLineTool {
       .help('h', 'help', help.deconz)
       .version('V', 'version')
       .option('H', 'host', (value) => {
-        homebridgeLib.OptionParser.toHost('host', value, false, true)
+        OptionParser.toHost('host', value, false, true)
         clargs.options.host = value
       })
       .option('K', 'apiKey', (value) => {
-        clargs.options.apiKey = homebridgeLib.OptionParser.toString(
+        clargs.options.apiKey = OptionParser.toString(
           'apiKey', value, true, true
         )
       })
@@ -416,7 +418,7 @@ class Main extends homebridgeLib.CommandLineTool {
         }
       })
       .option('t', 'timeout', (value) => {
-        clargs.options.timeout = homebridgeLib.OptionParser.toInt(
+        clargs.options.timeout = OptionParser.toInt(
           'timeout', value, 1, 60, true
         )
       })
@@ -449,13 +451,17 @@ class Main extends homebridgeLib.CommandLineTool {
     })
     this.deconzDiscovery
       .on('error', (error) => {
-        this.log(
-          '%s: request %d: %s %s', error.request.name,
-          error.request.id, error.request.method, error.request.resource
-        )
-        this.warn(
-          '%s: request %d: %s', error.request.name, error.request.id, error
-        )
+        if (error.request != null) {
+          this.log(
+            '%s: request %d: %s %s', error.request.name,
+            error.request.id, error.request.method, error.request.resource
+          )
+          this.warn(
+            '%s: request %d: %s', error.request.name, error.request.id, error
+          )
+          return
+        }
+        this.warn(error)
       })
       .on('request', (request) => {
         this.debug(
@@ -586,7 +592,7 @@ class Main extends homebridgeLib.CommandLineTool {
   // ===== GET =================================================================
 
   async get (...args) {
-    const parser = new homebridgeLib.CommandLineParser(packageJson)
+    const parser = new CommandLineParser(packageJson)
     const clargs = {
       options: {}
     }
@@ -605,14 +611,14 @@ class Main extends homebridgeLib.CommandLineTool {
       .flag('v', 'valuesOnly', () => { clargs.options.valuesOnly = true })
       .remaining((list) => {
         if (list.length > 1) {
-          throw new UsageError('too many paramters')
+          throw new UsageError('too many parameters')
         }
         clargs.resource = list.length === 0
           ? '/'
-          : homebridgeLib.OptionParser.toPath('resource', list[0])
+          : OptionParser.toPath('resource', list[0])
       })
       .parse(...args)
-    const jsonFormatter = new homebridgeLib.JsonFormatter(clargs.options)
+    const jsonFormatter = new JsonFormatter(clargs.options)
     const response = await this.client.get(clargs.resource)
     this.print(jsonFormatter.stringify(response))
   }
@@ -620,7 +626,7 @@ class Main extends homebridgeLib.CommandLineTool {
   // ===== PUT, POST, DELETE ===================================================
 
   async resourceCommand (command, ...args) {
-    const parser = new homebridgeLib.CommandLineParser(packageJson)
+    const parser = new CommandLineParser(packageJson)
     const clargs = {
       options: {}
     }
@@ -628,7 +634,7 @@ class Main extends homebridgeLib.CommandLineTool {
       .help('h', 'help', help[command])
       .flag('v', 'verbose', () => { clargs.options.verbose = true })
       .parameter('resource', (resource) => {
-        clargs.resource = homebridgeLib.OptionParser.toPath('resource', resource)
+        clargs.resource = OptionParser.toPath('resource', resource)
         if (clargs.resource === '/') {
           // deCONZ will crash otherwise, see deconz-rest-plugin#2520.
           throw new UsageError(`/: invalid resource for ${command}`)
@@ -636,7 +642,7 @@ class Main extends homebridgeLib.CommandLineTool {
       })
       .remaining((list) => {
         if (list.length > 1) {
-          throw new Error('too many paramters')
+          throw new Error('too many parameters')
         }
         if (list.length === 1) {
           try {
@@ -648,7 +654,7 @@ class Main extends homebridgeLib.CommandLineTool {
       })
       .parse(...args)
     const response = await this.client[command](clargs.resource, clargs.body)
-    const jsonFormatter = new homebridgeLib.JsonFormatter()
+    const jsonFormatter = new JsonFormatter()
     if (clargs.options.verbose || response.success == null) {
       this.print(jsonFormatter.stringify(response.body))
       return
@@ -688,7 +694,7 @@ class Main extends homebridgeLib.CommandLineTool {
   }
 
   async eventlog (...args) {
-    const parser = new homebridgeLib.CommandLineParser(packageJson)
+    const parser = new CommandLineParser(packageJson)
     let mode = 'daemon'
     const options = {}
     parser
@@ -697,7 +703,7 @@ class Main extends homebridgeLib.CommandLineTool {
       .flag('r', 'raw', () => { options.raw = true })
       .flag('s', 'service', () => { mode = 'service' })
       .parse(...args)
-    this.jsonFormatter = new homebridgeLib.JsonFormatter(
+    this.jsonFormatter = new JsonFormatter(
       mode === 'service' ? { noWhiteSpace: true } : {}
     )
     const { websocketport } = await this.client.get('/config')
@@ -741,7 +747,7 @@ class Main extends homebridgeLib.CommandLineTool {
   // ===========================================================================
 
   async simpleCommand (command, ...args) {
-    const parser = new homebridgeLib.CommandLineParser(packageJson)
+    const parser = new CommandLineParser(packageJson)
     const clargs = {
       options: {}
     }
@@ -750,7 +756,7 @@ class Main extends homebridgeLib.CommandLineTool {
       .flag('v', 'verbose', () => { clargs.options.verbose = true })
       .parse(...args)
     const response = await this.client[command]()
-    const jsonFormatter = new homebridgeLib.JsonFormatter()
+    const jsonFormatter = new JsonFormatter()
     for (const error of response.errors) {
       this.warn('api error %d: %s', error.type, error.description)
     }
@@ -770,45 +776,45 @@ class Main extends homebridgeLib.CommandLineTool {
   }
 
   async discover (...args) {
-    const parser = new homebridgeLib.CommandLineParser(packageJson)
+    const parser = new CommandLineParser(packageJson)
     let stealth = false
     parser
       .help('h', 'help', help.discover)
       .flag('S', 'stealth', () => { stealth = true })
       .parse(...args)
-    const jsonFormatter = new homebridgeLib.JsonFormatter({ sortKeys: true })
+    const jsonFormatter = new JsonFormatter({ sortKeys: true })
     const bridges = await this.deconzDiscovery.discover(stealth)
     this.print(jsonFormatter.stringify(bridges))
   }
 
   async config (...args) {
-    const parser = new homebridgeLib.CommandLineParser(packageJson)
+    const parser = new CommandLineParser(packageJson)
     const options = {}
     parser
       .help('h', 'help', help.config)
       .flag('s', 'sortKeys', () => { options.sortKeys = true })
       .parse(...args)
-    const jsonFormatter = new homebridgeLib.JsonFormatter(options)
+    const jsonFormatter = new JsonFormatter(options)
     const json = jsonFormatter.stringify(this.gatewayConfig)
     this.print(json)
   }
 
   async description (...args) {
-    const parser = new homebridgeLib.CommandLineParser(packageJson)
+    const parser = new CommandLineParser(packageJson)
     const options = {}
     parser
       .help('h', 'help', help.description)
       .flag('s', 'sortKeys', () => { options.sortKeys = true })
       .parse(...args)
     const response = await this.deconzDiscovery.description(this.clargs.options.host)
-    const jsonFormatter = new homebridgeLib.JsonFormatter(options)
+    const jsonFormatter = new JsonFormatter(options)
     const json = jsonFormatter.stringify(response)
     this.print(json)
   }
 
   async getApiKey (...args) {
-    const parser = new homebridgeLib.CommandLineParser(packageJson)
-    const jsonFormatter = new homebridgeLib.JsonFormatter(
+    const parser = new CommandLineParser(packageJson)
+    const jsonFormatter = new JsonFormatter(
       { noWhiteSpace: true, sortKeys: true }
     )
     parser
@@ -834,17 +840,15 @@ class Main extends homebridgeLib.CommandLineTool {
   // ===== LIGHTVALUES =========================================================
 
   async probe (...args) {
-    const parser = new homebridgeLib.CommandLineParser(packageJson)
+    const parser = new CommandLineParser(packageJson)
     const clargs = {
       maxCount: 60
     }
     parser
       .help('h', 'help', help.probe)
       .flag('v', 'verbose', () => { clargs.verbose = true })
-      .option('t', 'timeout', (value, key) => {
-        homebridgeLib.OptionParser.toInt(
-          'timeout', value, 1, 10, true
-        )
+      .option('t', 'timeout', (value) => {
+        OptionParser.toInt('timeout', value, 1, 10, true)
         clargs.maxCount = value * 12
       })
       .parameter('light', (value) => {
@@ -929,7 +933,7 @@ class Main extends homebridgeLib.CommandLineTool {
       response.xy.b = await probeXy.call(this, 'blue', [zero, zero])
     }
     await this.client.put(clargs.light + '/state', { on: light.state.on })
-    this.jsonFormatter = new homebridgeLib.JsonFormatter()
+    this.jsonFormatter = new JsonFormatter()
     const json = this.jsonFormatter.stringify(response)
     this.print(json)
   }
@@ -937,7 +941,7 @@ class Main extends homebridgeLib.CommandLineTool {
   // ===== BRIDGE/GATEWAY DISCOVERY ==============================================
 
   async restart (...args) {
-    const parser = new homebridgeLib.CommandLineParser(packageJson)
+    const parser = new CommandLineParser(packageJson)
     const clargs = {}
     parser
       .help('h', 'help', help.restart)

package/cli/ui.js

@@ -0,0 +1,419 @@
+#!/usr/bin/env node
+
+// homebridge-deconz/cli/deconz.js
+// Copyright © 2018-2023 Erik Baauw. All rights reserved.
+//
+// Command line interface to Homebridge deCONZ UI Server.
+
+'use strict'
+
+const fs = require('fs').promises
+// const Deconz = require('../lib/Deconz')
+const {
+  CommandLineParser, CommandLineTool, HttpClient, JsonFormatter, OptionParser
+} = require('hb-lib-tools')
+const packageJson = require('../package.json')
+
+const { b, u } = CommandLineTool
+const { UsageError } = CommandLineParser
+
+const usage = {
+  ui: `${b('ui')} [${b('-hVD')}] [${b('-U')} ${u('username')}] [${b('-G')} ${u('gateway')}] [${b('-t')} ${u('timeout')}] ${u('command')} [${u('argument')} ...]`,
+  get: `${b('get')} [${b('-hsnjuatlkv')}] [${b('/devices')}[${b('/')}${u('id')}] | ${b('/accessories')}[${b('/')}${u('id')}]]`,
+  put: `${b('put')} [${b('-hsnjuatlkv')}] [${b('/devices/')}${u('id')}] | ${b('/accessories/')}${u('id')}]] ${u('body')}`
+}
+
+const description = {
+  ui: 'Command line interface to Homebridge deCONZ UI Server for dynamic settings.',
+  get: 'Get dynamic settings.',
+  put: 'Update dynamic settings.'
+}
+
+const help = {
+  ui: `${description.ui}
+
+Usage: ${usage.ui}
+
+Parameters:
+  ${b('-h')}, ${b('--help')}
+  Print this help and exit.
+
+  ${b('-V')}, ${b('--version')}
+  Print version and exit.
+
+  ${b('-D')}, ${b('--debug')}
+  Print debug messages for communication with the Homebridge deCONZ UI Server.
+
+  ${b('-U')} ${u('username')}, ${b('--username=')}${u('username')}
+  Specify the username of the Homebridge instance.  Default: first instance in config.json.
+
+  ${b('-G')} ${u('gateway')}, ${b('--gateway=')}${u('gateway')}
+  Specify the id of the deCONZ gateway.  Default: first gateway in cachedAccessories.
+
+  ${b('-t')} ${u('timeout')}, ${b('--timeout=')}${u('timeout')}
+  Set timeout to ${u('timeout')} seconds instead of default ${b(5)}.
+
+Commands:
+  ${usage.get}
+  ${description.get}
+
+  ${usage.put}
+  ${description.put}
+
+For more help, issue: ${b('ui')} ${u('command')} ${b('-h')}`,
+  get: `${description.get}
+
+Usage: ${b('ui')} ${usage.get}
+
+Parameters:
+  ${b('-h')}, ${b('--help')}
+  Print this help and exit.
+
+  ${b('-s')}, ${b('--sortKeys')}
+  Sort object key/value pairs alphabetically on key.
+
+  ${b('-n')}, ${b('-noWhiteSpace')}
+  Do not include spaces nor newlines in the output.
+
+  ${b('-j')}, ${b('--jsonArray')}
+  Output a JSON array of objects for each key/value pair.
+  Each object contains two key/value pairs: key "keys" with an array
+  of keys as value and key "value" with the value as value.
+
+  ${b('-u')}, ${b('--joinKeys')}
+  Output JSON array of objects for each key/value pair.
+  Each object contains one key/value pair: the path (concatenated
+  keys separated by '/') as key and the value as value.
+
+  ${b('-a')}, ${b('--ascii')}
+  Output path:value in plain text instead of JSON.
+
+  ${b('-t')}, ${b('--topOnly')}
+  Limit output to top-level key/values.
+
+  ${b('-l')}, ${b('--leavesOnly')}
+  Limit output to leaf (non-array, non-object) key/values.
+
+  ${b('-k')}, ${b('--keysOnly')}
+  Limit output to keys. With ${b('-u')}, output a JSON array of paths.
+
+  ${b('-v')}, ${b('--valuesOnly')}
+  Limit output to values. With ${b('-u')}, output a JSON array of values.`,
+  put: `${description.put}
+
+Usage: ${b('ui')} ${usage.put}
+  
+Parameters:
+  xxx`
+}
+
+class Main extends CommandLineTool {
+  constructor () {
+    super({ mode: 'command', debug: false })
+    this.usage = usage.deconz
+  }
+
+  parseArguments () {
+    const parser = new CommandLineParser(packageJson)
+    const clargs = {
+      options: {
+        timeout: 5
+      }
+    }
+    parser
+      .help('h', 'help', help.ui)
+      .version('V', 'version')
+      .flag('D', 'debug', () => {
+        if (this.debugEnabled) {
+          this.setOptions({ vdebug: true })
+        } else {
+          this.setOptions({ debug: true, chalk: true })
+        }
+      })
+      .option('U', 'username', (value) => {
+        clargs.username = OptionParser.toString(
+          'username', value, true, true
+        ).toUpperCase()
+        if (!OptionParser.patterns.mac.test(clargs.username)) {
+          throw new UsageError(`${clargs.username}: invalid username`)
+        }
+      })
+      .option('G', 'gateway', (value) => {
+        clargs.gateway = OptionParser.toString(
+          'gateway', value, true, true
+        ).toUpperCase()
+      })
+      .option('t', 'timeout', (value) => {
+        clargs.options.timeout = OptionParser.toInt(
+          'timeout', value, 1, 60, true
+        )
+      })
+      .parameter('command', (value) => {
+        if (usage[value] == null || typeof this[value] !== 'function') {
+          throw new UsageError(`${value}: unknown command`)
+        }
+        clargs.command = value
+      })
+      .remaining((list) => { clargs.args = list })
+    parser
+      .parse()
+    return clargs
+  }
+
+  async main () {
+    try {
+      await this._main()
+    } catch (error) {
+      if (error.request == null) {
+        this.error(error)
+      }
+    }
+  }
+
+  /** Read and parse a JSON file.
+    *
+    * @param {string} filename - The name of the JSON file.
+    * @returns {*} body - The contents of the JSON file as JavaScript object.
+    */
+  async readJsonFile (filename) {
+    this.vdebug('reading %s', filename)
+    const text = await fs.readFile(filename)
+    this.debug('%s: %d bytes', filename, text.length)
+    const body = JSON.parse(text)
+    this.vdebug('%s: %j', filename, body)
+    return body
+  }
+
+  /** Read Homebridge's cachedAccessories.
+    *
+    * @param {string} dir - The Homebridge user directory.
+    * @param {string} username - The username (mac address) of the Homebridge bridge.
+    * @param {string} platformName - The name of the platform.
+    * @returns {Array<SerialisedAccessory>} accessories - The serialsed accessories.
+    */
+  async readCachedAccessories (dir, username, platformName) {
+    let filename = dir + '/accessories/cachedAccessories'
+    if (username != null) {
+      filename += '.' + username.replace(/:/g, '').toUpperCase()
+    }
+    const body = await this.readJsonFile(filename)
+    return body.filter((accessory) => {
+      return accessory.platform === platformName
+    })
+  }
+
+  /** Get platform entries from Homebridge's config.json file.
+    *
+    * @param {string} dir - The Homebridge user directory.
+    * @param {string} platformName - The name of the platform.
+    * @returns {Array<PlatformInfo>} platforms - Array of matching platforms.
+    */
+  async _getPlatforms (dir, platformName) {
+    const filename = dir + '/config.json'
+    const config = await this.readJsonFile(filename)
+    const gateways = []
+    for (const platform of config.platforms) {
+      if (platform.platform !== platformName) {
+        continue
+      }
+      try {
+        const username = platform._bridge == null ? null : platform._bridge.username
+        const cachedAccessories = await this.readCachedAccessories(dir, username, platformName)
+        const cachedGateways = cachedAccessories.filter((accessory) => {
+          return accessory.context.className === 'Gateway'
+        })
+        for (const gateway of cachedGateways) {
+          gateways.push({
+            platformName: platform.name == null ? platform.platform : platform.name,
+            username,
+            uiPort: gateway.context.uiPort,
+            gid: gateway.context.id,
+            name: gateway.context.name
+          })
+        }
+      } catch (error) { this.warn(error) }
+    }
+    return gateways
+  }
+
+  /** Get platform entries from Homebridge's config.json file.
+    *
+    * @param {string} platformName - The name of the platform.
+    * @returns {Array<PlatformInfo>} platforms - Array of matching platforms.
+    */
+  async getPlatforms (platformName) {
+    if (process.env.HOMEBRIDGE_DIR != null) {
+      return this._getPlatforms(process.env.HOMEBRIDGE_DIR, platformName)
+    }
+    for (const dir of ['/var/lib/homebridge', process.env.HOME + '/.homebridge', '.']) {
+      try {
+        return await this._getPlatforms(dir, platformName)
+      } catch (error) {
+        if (error.code !== 'ENOENT') {
+          throw error
+        }
+      }
+    }
+    throw new Error('cannot find config.json - please set HOMEBRIDGE_DIR')
+  }
+
+  /** Create a client to the UI server.
+    *
+    * @param {integer} uiPort - The port for the UI server.
+    * @returns {HttpClient} client - The UI client
+    */
+  async createUiClient (uiPort) {
+    const host = 'localhost:' + uiPort
+    const client = new HttpClient({
+      host,
+      json: true,
+      name: host,
+      timeout: this.clargs.options.timeout
+    })
+    client
+      .on('error', (error) => {
+        if (error.request.id !== this.requestId) {
+          if (error.request.body == null) {
+            this.log(
+              '%s: request %d: %s %s', error.request.name, error.request.id,
+              error.request.method, error.request.resource
+            )
+          } else {
+            this.log(
+              '%s: request %d: %s %s %s', error.request.name, error.request.id,
+              error.request.method, error.request.resource, error.request.body
+            )
+          }
+          this.requestId = error.request.id
+        }
+        this.error('%s: request %d: %s', error.request.name, error.request.id, error)
+      })
+      .on('request', (request) => {
+        if (request.body == null) {
+          this.debug(
+            '%s: request %d: %s %s', request.name, request.id,
+            request.method, request.resource
+          )
+          this.vdebug(
+            '%s: request %d: %s %s', request.name, request.id,
+            request.method, request.url
+          )
+        } else {
+          this.debug(
+            '%s: request %d: %s %s %s', request.name, request.id,
+            request.method, request.resource, request.body
+          )
+          this.vdebug(
+            '%s: request %d: %s %s %s', request.name, request.id,
+            request.method, request.url, request.body
+          )
+        }
+      })
+      .on('response', (response) => {
+        this.vdebug(
+          '%s: request %d: response: %j', response.request.name, response.request.id,
+          response.body
+        )
+        this.debug(
+          '%s: request %d: %d %s', response.request.name, response.request.id,
+          response.statusCode, response.statusMessage
+        )
+      })
+    const response = await client.get('/ping')
+    if (response.body !== 'pong') {
+      throw new Error(`${host}: cannot ping`)
+    }
+    return client
+  }
+
+  async _main () {
+    this.clargs = this.parseArguments()
+    this.name = 'ui ' + this.clargs.command
+    this.usage = `${b('ui')} ${usage[this.clargs.command]}`
+    let platforms = await this.getPlatforms('deCONZ')
+    if (platforms.length === 0) {
+      throw new Error('no UI server found')
+    }
+    if (this.clargs.username != null) {
+      platforms = platforms.filter((platform) => {
+        return platform.username === this.clargs.username
+      })
+      if (platforms.length === 0) {
+        throw new Error(`no UI server found for bridge ${this.clargs.username}`)
+      }
+    }
+    if (this.clargs.gateway != null) {
+      platforms = platforms.filter((platform) => {
+        return platform.gid === this.clargs.gateway
+      })
+      if (platforms.length === 0) {
+        throw new Error(`no UI server found for gateway ${this.clargs.gateway}`)
+      }
+    }
+    const { gid, uiPort } = platforms[0]
+    this.client = await this.createUiClient(uiPort)
+    this.gid = gid
+    return this[this.clargs.command](this.clargs.args)
+  }
+
+  async get (...args) {
+    const parser = new CommandLineParser(packageJson)
+    const clargs = {
+      options: {}
+    }
+    parser
+      .help('h', 'help', help.get)
+      .flag('s', 'sortKeys', () => { clargs.options.sortKeys = true })
+      .flag('n', 'noWhiteSpace', () => {
+        clargs.options.noWhiteSpace = true
+      })
+      .flag('j', 'jsonArray', () => { clargs.options.noWhiteSpace = true })
+      .flag('u', 'joinKeys', () => { clargs.options.joinKeys = true })
+      .flag('a', 'ascii', () => { clargs.options.ascii = true })
+      .flag('t', 'topOnly', () => { clargs.options.topOnly = true })
+      .flag('l', 'leavesOnly', () => { clargs.options.leavesOnly = true })
+      .flag('k', 'keysOnly', () => { clargs.options.keysOnly = true })
+      .flag('v', 'valuesOnly', () => { clargs.options.valuesOnly = true })
+      .parameter('resource', (value) => {
+        clargs.resource = OptionParser.toPath('resource', value)
+      })
+      .parse(...args)
+    if (clargs.resource === '/') {
+      clargs.resource = ''
+    }
+    const jsonFormatter = new JsonFormatter(clargs.options)
+    const { body } = await this.client.get('/gateways/' + this.gid + clargs.resource)
+    this.print(jsonFormatter.stringify(body))
+  }
+
+  async put (...args) {
+    const parser = new CommandLineParser(packageJson)
+    const clargs = {
+      options: {}
+    }
+    parser
+      .help('h', 'help', help.get)
+      .parameter('resource', (value) => {
+        clargs.resource = OptionParser.toPath('resource', value)
+      })
+      .parameter('body', (value) => {
+        value = OptionParser.toString('body', value, true, true)
+        try {
+          clargs.body = JSON.parse(value)
+        } catch (error) {
+          throw new UsageError(error.message) // Covert TypeError to UsageError.
+        }
+      })
+      .parse(...args)
+    if (clargs.resource === '/') {
+      clargs.resource = ''
+    }
+    const jsonFormatter = new JsonFormatter(clargs.options)
+    const { body } = await this.client.put(
+      '/gateways/' + this.gid + clargs.resource + '/settings', clargs.body
+    )
+    this.print(jsonFormatter.stringify(body))
+  }
+}
+
+new Main().main()