@oclif/core 4.0.13 → 4.0.15

package/README.md

@@ -101,6 +101,30 @@ $ ts-node myscript.ts
 ...files in current dir...
 ```
 
+You can also use oclif's `Parser` separately:
+
+```javascript
+// index.js
+import {Args, Flags, Parser} from '@oclif/core'
+
+const {args, flags} = await Parser.parse(process.argv.slice(2), {
+  args: {
+    name: Args.string({required: true}),
+  },
+  flags: {
+    from: Flags.string({char: 'f', default: 'oclif'}),
+  },
+})
+
+console.log(`hello ${args.name} from ${flags.form}`)
+```
+
+```
+$ node index.js world --from oclif
+
+hello world from oclif
+```
+
 🚀 Contributing
 
 See the [contributing guide](./CONRTIBUTING.md).

package/lib/parser/parse.js

@@ -303,13 +303,18 @@ class Parser {
                 }
                 // multiple with custom delimiter
                 if (fws.inputFlag.flag.type === 'option' && fws.inputFlag.flag.delimiter && fws.inputFlag.flag.multiple) {
+                    // regex that will identify unescaped delimiters
+                    const makeDelimiter = (delimiter) => new RegExp(`(?<!\\\\)${delimiter}`);
                     return {
                         ...fws,
                         valueFunction: async (i) => (await Promise.all((i.tokens ?? [])
-                            .flatMap((token) => token.input.split(i.inputFlag.flag.delimiter ?? ','))
+                            .flatMap((token) => token.input.split(makeDelimiter(i.inputFlag.flag.delimiter ?? ',')))
                             // trim, and remove surrounding doubleQuotes (which would hav been needed if the elements contain spaces)
                             .map((v) => v
                             .trim()
+                            // remove escaped characters from delimiter
+                            // example: --opt="a\,b,c" -> ["a,b", "c"]
+                            .replaceAll(new RegExp(`\\\\${i.inputFlag.flag.delimiter}`, 'g'), i.inputFlag.flag.delimiter ?? ',')
                             .replace(/^"(.*)"$/, '$1')
                             .replace(/^'(.*)'$/, '$1'))
                             .map(async (v) => parseFlagOrThrowError(v, i.inputFlag.flag, this.context, {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oclif/core",
   "description": "base library for oclif CLIs",
-  "version": "4.0.13",
+  "version": "4.0.15",
   "author": "Salesforce",
   "bugs": "https://github.com/oclif/core/issues",
   "dependencies": {
@@ -52,7 +52,7 @@
     "eslint-config-oclif": "^5.2.0",
     "eslint-config-oclif-typescript": "^3.1.8",
     "eslint-config-prettier": "^9.1.0",
-    "husky": "^9",
+    "husky": "^9.1.1",
     "lint-staged": "^15",
     "madge": "^6.1.0",
     "mocha": "^10.6.0",