| /** |
| * @fileoverview Main entrypoint for libraries using yargs-parser in Node.js |
| * CJS and ESM environments. |
| * |
| * @license |
| * Copyright (c) 2016, Contributors |
| * SPDX-License-Identifier: ISC |
| */ |
| import { format } from 'util'; |
| import { readFileSync } from 'fs'; |
| import { normalize, resolve } from 'path'; |
| import { camelCase, decamelize, looksLikeNumber } from './string-utils.js'; |
| import { YargsParser } from './yargs-parser.js'; |
| // See https://github.com/yargs/yargs-parser#supported-nodejs-versions for our |
| // version support policy. The YARGS_MIN_NODE_VERSION is used for testing only. |
| const minNodeVersion = (process && process.env && process.env.YARGS_MIN_NODE_VERSION) |
| ? Number(process.env.YARGS_MIN_NODE_VERSION) |
| : 10; |
| if (process && process.version) { |
| const major = Number(process.version.match(/v([^.]+)/)[1]); |
| if (major < minNodeVersion) { |
| throw Error(`yargs parser supports a minimum Node.js version of ${minNodeVersion}. Read our version support policy: https://github.com/yargs/yargs-parser#supported-nodejs-versions`); |
| } |
| } |
| // Creates a yargs-parser instance using Node.js standard libraries: |
| const env = process ? process.env : {}; |
| const parser = new YargsParser({ |
| cwd: process.cwd, |
| env: () => { |
| return env; |
| }, |
| format, |
| normalize, |
| resolve, |
| // TODO: figure out a way to combine ESM and CJS coverage, such that |
| // we can exercise all the lines below: |
| require: (path) => { |
| if (typeof require !== 'undefined') { |
| return require(path); |
| } |
| else if (path.match(/\.json$/)) { |
| return readFileSync(path, 'utf8'); |
| } |
| else { |
| throw Error('only .json config files are supported in ESM'); |
| } |
| } |
| }); |
| const yargsParser = function Parser(args, opts) { |
| const result = parser.parse(args.slice(), opts); |
| return result.argv; |
| }; |
| yargsParser.detailed = function (args, opts) { |
| return parser.parse(args.slice(), opts); |
| }; |
| yargsParser.camelCase = camelCase; |
| yargsParser.decamelize = decamelize; |
| yargsParser.looksLikeNumber = looksLikeNumber; |
| export default yargsParser; |