jackspeak 1.3.8 → 1.4.0

package/README.md

@@ -25,6 +25,14 @@ as argument names as well; just put them in different sections.
       explicitly set.
     - `original` The `argv` array before any expansions.
     - `parsed` The `argv` array once all aliases have been expanded.
+    - `reparse` A function that takes a string or array of strings, and
+      parses it according to the options initially provided.  Note that
+      this does _not_ update the results object, it's just for expanding
+      aliases and short options.
+    - `update` A function that takes either a single `--key=val`, an array
+      of `--key=val` values, or an object (as read from an rc file, for
+      example), and updates the result data accordingly.  This will _not_
+      update any options set explicitly in the original argv.
 
 - `usage` String or Array
 

package/index.js

@@ -162,6 +162,47 @@ const usage = j => {
 // }
 const jack = (...sections) => execute(parse_(buildParser(newObj(), sections)))
 
+const kvToArg = j => (k, v) =>
+  j.options[k] && isFlag(j.options[k]) ? (v ? `--${k}` : `--no-${k}`)
+  : `--${k}=${v}`
+
+const objToArgv = j => obj => Object.keys(obj).reduce((set, k) => {
+  const toArg = kvToArg(j)
+  const val = obj[k]
+  if (Array.isArray(val))
+    set.push(...val.map(v => toArg(k, v)))
+  else
+    set.push(toArg(k, val))
+  return set
+}, [])
+
+const update = j => args => {
+  const argv = []
+  const toArgv = objToArgv(j)
+  if (typeof args === 'string')
+    argv.push(args)
+  else if (Array.isArray(args))
+    argv.push(...args)
+  else if (args)
+    argv.push(...toArgv(args))
+  const result = reparse(j)(argv)
+  Object.keys(result)
+    .filter(k => k !== '_' && !j.explicit.has(k))
+    .forEach(k => j.result[k] = result[k])
+}
+
+const reparse = j => args => {
+  const argv = Array.isArray(args) ? args : [args]
+  return parse_({
+    ...j,
+    explicit: new Set(),
+    result: { _: [] },
+    help: [],
+    main: null,
+    argv,
+  }).result
+}
+
 const newObj = () => ({
   help: [],
   shortOpts: {},
@@ -582,6 +623,8 @@ const parse_ = j => {
   Object.defineProperty(j.result._, 'usage', {
     value: () => console.log(usage(j))
   })
+  Object.defineProperty(j.result._, 'update', { value: update(j) })
+  Object.defineProperty(j.result._, 'reparse', { value: reparse(j) })
   Object.defineProperty(j.result._, 'explicit', { value: j.explicit })
   Object.defineProperty(j.result._, 'parsed', { value: argv })
   Object.defineProperty(j.result._, 'original', { value: original })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jackspeak",
-  "version": "1.3.8",
+  "version": "1.4.0",
   "description": "A very strict and proper argument parser.",
   "main": "index.js",
   "scripts": {
@@ -13,7 +13,7 @@
   },
   "license": "ISC",
   "devDependencies": {
-    "tap": "^13.0.0-rc.25"
+    "tap": "^14.0.0"
   },
   "files": [
     "index.js"