1205 lines
23 KiB
JavaScript
1205 lines
23 KiB
JavaScript
/*!
|
|
* config.js - configuration parsing for bcoin
|
|
* Copyright (c) 2016-2017, Christopher Jeffrey (MIT License).
|
|
* https://github.com/bcoin-org/bcoin
|
|
*/
|
|
|
|
'use strict';
|
|
|
|
const assert = require('bsert');
|
|
const Path = require('path');
|
|
const os = require('os');
|
|
const fs = require('./fs');
|
|
const HOME = os.homedir ? os.homedir() : '/';
|
|
|
|
/**
|
|
* Config Parser
|
|
*/
|
|
|
|
class Config {
|
|
/**
|
|
* Create a config.
|
|
* @constructor
|
|
* @param {String} module - Module name (e.g. `bcoin`).
|
|
* @param {Object?} options
|
|
*/
|
|
|
|
constructor(module, options) {
|
|
assert(typeof module === 'string');
|
|
assert(module.length > 0);
|
|
|
|
this.module = module;
|
|
this.prefix = Path.join(HOME, `.${module}`);
|
|
this.suffix = null;
|
|
this.fallback = null;
|
|
this.alias = Object.create(null);
|
|
|
|
this.options = Object.create(null);
|
|
this.data = Object.create(null);
|
|
this.env = Object.create(null);
|
|
this.args = Object.create(null);
|
|
this.argv = [];
|
|
this.pass = [];
|
|
this.query = Object.create(null);
|
|
this.hash = Object.create(null);
|
|
|
|
if (options)
|
|
this.init(options);
|
|
}
|
|
|
|
/**
|
|
* Initialize options.
|
|
* @private
|
|
* @param {Object} options
|
|
*/
|
|
|
|
init(options) {
|
|
assert(options && typeof options === 'object');
|
|
|
|
if (options.suffix != null) {
|
|
assert(typeof options.suffix === 'string');
|
|
this.suffix = options.suffix;
|
|
}
|
|
|
|
if (options.fallback != null) {
|
|
assert(typeof options.fallback === 'string');
|
|
this.fallback = options.fallback;
|
|
}
|
|
|
|
if (options.alias) {
|
|
assert(typeof options.alias === 'object');
|
|
for (const key of Object.keys(options.alias)) {
|
|
const value = options.alias[key];
|
|
assert(typeof value === 'string');
|
|
this.alias[key] = value;
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Inject options.
|
|
* @param {Object} options
|
|
*/
|
|
|
|
inject(options) {
|
|
for (const key of Object.keys(options)) {
|
|
const value = options[key];
|
|
|
|
switch (key) {
|
|
case 'hash':
|
|
case 'query':
|
|
case 'env':
|
|
case 'argv':
|
|
case 'config':
|
|
continue;
|
|
}
|
|
|
|
this.set(key, value);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Load options from hash, query, env, or args.
|
|
* @param {Object} options
|
|
*/
|
|
|
|
load(options) {
|
|
if (options.hash)
|
|
this.parseHash(options.hash);
|
|
|
|
if (options.query)
|
|
this.parseQuery(options.query);
|
|
|
|
if (options.env)
|
|
this.parseEnv(options.env);
|
|
|
|
if (options.argv)
|
|
this.parseArg(options.argv);
|
|
|
|
this.prefix = this.getPrefix();
|
|
}
|
|
|
|
/**
|
|
* Open a config file.
|
|
* @param {String} file - e.g. `bcoin.conf`.
|
|
* @throws on IO error
|
|
*/
|
|
|
|
open(file) {
|
|
if (fs.unsupported)
|
|
return;
|
|
|
|
const path = this.getFile(file);
|
|
|
|
let text;
|
|
try {
|
|
text = fs.readFileSync(path, 'utf8');
|
|
} catch (e) {
|
|
if (e.code === 'ENOENT')
|
|
return;
|
|
throw e;
|
|
}
|
|
|
|
this.parseConfig(text);
|
|
|
|
this.prefix = this.getPrefix();
|
|
}
|
|
|
|
/**
|
|
* Create a child config. Filter by plugin name.
|
|
* @param {String} name
|
|
* @returns {Config}
|
|
*/
|
|
|
|
filter(name) {
|
|
assert(typeof name === 'string');
|
|
|
|
const child = new Config(this.module);
|
|
|
|
child.prefix = this.prefix;
|
|
child.suffix = this.suffix;
|
|
child.fallback = this.fallback;
|
|
child.argv = this.argv;
|
|
child.pass = this.pass;
|
|
|
|
_filter(name, this.env, child.env);
|
|
_filter(name, this.args, child.args);
|
|
_filter(name, this.query, child.query);
|
|
_filter(name, this.hash, child.hash);
|
|
_filter(name, this.options, child.options);
|
|
|
|
return child;
|
|
}
|
|
|
|
/**
|
|
* Set default option.
|
|
* @param {String} key
|
|
* @param {Object} value
|
|
*/
|
|
|
|
set(key, value) {
|
|
assert(typeof key === 'string', 'Key must be a string.');
|
|
|
|
if (value == null)
|
|
return;
|
|
|
|
key = key.replace(/-/g, '');
|
|
key = key.toLowerCase();
|
|
|
|
this.options[key] = value;
|
|
}
|
|
|
|
/**
|
|
* Test whether a config option is present.
|
|
* @param {String} key
|
|
* @returns {Boolean}
|
|
*/
|
|
|
|
has(key) {
|
|
if (typeof key === 'number') {
|
|
assert(key >= 0, 'Index must be positive.');
|
|
if (key >= this.argv.length)
|
|
return false;
|
|
return true;
|
|
}
|
|
|
|
assert(typeof key === 'string', 'Key must be a string.');
|
|
|
|
key = key.replace(/-/g, '');
|
|
key = key.toLowerCase();
|
|
|
|
if (this.hash[key] != null)
|
|
return true;
|
|
|
|
if (this.query[key] != null)
|
|
return true;
|
|
|
|
if (this.args[key] != null)
|
|
return true;
|
|
|
|
if (this.env[key] != null)
|
|
return true;
|
|
|
|
if (this.data[key] != null)
|
|
return true;
|
|
|
|
if (this.options[key] != null)
|
|
return true;
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Get a config option.
|
|
* @param {String} key
|
|
* @param {Object?} fallback
|
|
* @returns {Object|null}
|
|
*/
|
|
|
|
get(key, fallback) {
|
|
if (fallback === undefined)
|
|
fallback = null;
|
|
|
|
if (Array.isArray(key)) {
|
|
const keys = key;
|
|
for (const key of keys) {
|
|
const value = this.get(key);
|
|
if (value !== null)
|
|
return value;
|
|
}
|
|
return fallback;
|
|
}
|
|
|
|
if (typeof key === 'number') {
|
|
assert(key >= 0, 'Index must be positive.');
|
|
|
|
if (key >= this.argv.length)
|
|
return fallback;
|
|
|
|
if (this.argv[key] != null)
|
|
return this.argv[key];
|
|
|
|
return fallback;
|
|
}
|
|
|
|
assert(typeof key === 'string', 'Key must be a string.');
|
|
|
|
key = key.replace(/-/g, '');
|
|
key = key.toLowerCase();
|
|
|
|
if (this.hash[key] != null)
|
|
return this.hash[key];
|
|
|
|
if (this.query[key] != null)
|
|
return this.query[key];
|
|
|
|
if (this.args[key] != null)
|
|
return this.args[key];
|
|
|
|
if (this.env[key] != null)
|
|
return this.env[key];
|
|
|
|
if (this.data[key] != null)
|
|
return this.data[key];
|
|
|
|
if (this.options[key] != null)
|
|
return this.options[key];
|
|
|
|
return fallback;
|
|
}
|
|
|
|
/**
|
|
* Get a value's type.
|
|
* @param {String} key
|
|
* @returns {String}
|
|
*/
|
|
|
|
typeOf(key) {
|
|
const value = this.get(key);
|
|
|
|
if (value === null)
|
|
return 'null';
|
|
|
|
return typeof value;
|
|
}
|
|
|
|
/**
|
|
* Get a config option (as a string).
|
|
* @param {String} key
|
|
* @param {Object?} fallback
|
|
* @returns {String|null}
|
|
*/
|
|
|
|
str(key, fallback) {
|
|
const value = this.get(key);
|
|
|
|
if (fallback === undefined)
|
|
fallback = null;
|
|
|
|
if (value === null)
|
|
return fallback;
|
|
|
|
if (typeof value !== 'string')
|
|
throw new Error(`${fmt(key)} must be a string.`);
|
|
|
|
return value;
|
|
}
|
|
|
|
/**
|
|
* Get a config option (as an integer).
|
|
* @param {String} key
|
|
* @param {Object?} fallback
|
|
* @returns {Number|null}
|
|
*/
|
|
|
|
int(key, fallback) {
|
|
const value = this.get(key);
|
|
|
|
if (fallback === undefined)
|
|
fallback = null;
|
|
|
|
if (value === null)
|
|
return fallback;
|
|
|
|
if (typeof value !== 'string') {
|
|
if (typeof value !== 'number')
|
|
throw new Error(`${fmt(key)} must be an int.`);
|
|
|
|
if (!Number.isSafeInteger(value))
|
|
throw new Error(`${fmt(key)} must be an int.`);
|
|
|
|
return value;
|
|
}
|
|
|
|
if (!/^\-?\d+$/.test(value))
|
|
throw new Error(`${fmt(key)} must be an int.`);
|
|
|
|
const num = parseInt(value, 10);
|
|
|
|
if (!Number.isSafeInteger(num))
|
|
throw new Error(`${fmt(key)} must be an int.`);
|
|
|
|
return num;
|
|
}
|
|
|
|
/**
|
|
* Get a config option (as a unsigned integer).
|
|
* @param {String} key
|
|
* @param {Object?} fallback
|
|
* @returns {Number|null}
|
|
*/
|
|
|
|
uint(key, fallback) {
|
|
const value = this.int(key);
|
|
|
|
if (fallback === undefined)
|
|
fallback = null;
|
|
|
|
if (value === null)
|
|
return fallback;
|
|
|
|
if (value < 0)
|
|
throw new Error(`${fmt(key)} must be a uint.`);
|
|
|
|
return value;
|
|
}
|
|
|
|
/**
|
|
* Get a config option (as a float).
|
|
* @param {String} key
|
|
* @param {Object?} fallback
|
|
* @returns {Number|null}
|
|
*/
|
|
|
|
float(key, fallback) {
|
|
const value = this.get(key);
|
|
|
|
if (fallback === undefined)
|
|
fallback = null;
|
|
|
|
if (value === null)
|
|
return fallback;
|
|
|
|
if (typeof value !== 'string') {
|
|
if (typeof value !== 'number')
|
|
throw new Error(`${fmt(key)} must be a float.`);
|
|
|
|
if (!isFinite(value))
|
|
throw new Error(`${fmt(key)} must be a float.`);
|
|
|
|
return value;
|
|
}
|
|
|
|
if (!/^\-?\d*(?:\.\d*)?$/.test(value))
|
|
throw new Error(`${fmt(key)} must be a float.`);
|
|
|
|
if (!/\d/.test(value))
|
|
throw new Error(`${fmt(key)} must be a float.`);
|
|
|
|
const num = parseFloat(value);
|
|
|
|
if (!isFinite(num))
|
|
throw new Error(`${fmt(key)} must be a float.`);
|
|
|
|
return num;
|
|
}
|
|
|
|
/**
|
|
* Get a config option (as a positive float).
|
|
* @param {String} key
|
|
* @param {Object?} fallback
|
|
* @returns {Number|null}
|
|
*/
|
|
|
|
ufloat(key, fallback) {
|
|
const value = this.float(key);
|
|
|
|
if (fallback === undefined)
|
|
fallback = null;
|
|
|
|
if (value === null)
|
|
return fallback;
|
|
|
|
if (value < 0)
|
|
throw new Error(`${fmt(key)} must be a positive float.`);
|
|
|
|
return value;
|
|
}
|
|
|
|
/**
|
|
* Get a value (as a fixed number).
|
|
* @param {String} key
|
|
* @param {Number?} exp
|
|
* @param {Object?} fallback
|
|
* @returns {Number|null}
|
|
*/
|
|
|
|
fixed(key, exp, fallback) {
|
|
const value = this.float(key);
|
|
|
|
if (fallback === undefined)
|
|
fallback = null;
|
|
|
|
if (value === null)
|
|
return fallback;
|
|
|
|
try {
|
|
return fromFloat(value, exp || 0);
|
|
} catch (e) {
|
|
throw new Error(`${fmt(key)} must be a fixed number.`);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get a value (as a positive fixed number).
|
|
* @param {String} key
|
|
* @param {Number?} exp
|
|
* @param {Object?} fallback
|
|
* @returns {Number|null}
|
|
*/
|
|
|
|
ufixed(key, exp, fallback) {
|
|
const value = this.fixed(key, exp);
|
|
|
|
if (fallback === undefined)
|
|
fallback = null;
|
|
|
|
if (value === null)
|
|
return fallback;
|
|
|
|
if (value < 0)
|
|
throw new Error(`${fmt(key)} must be a positive fixed number.`);
|
|
|
|
return value;
|
|
}
|
|
|
|
/**
|
|
* Get a config option (as a boolean).
|
|
* @param {String} key
|
|
* @param {Object?} fallback
|
|
* @returns {Boolean|null}
|
|
*/
|
|
|
|
bool(key, fallback) {
|
|
const value = this.get(key);
|
|
|
|
if (fallback === undefined)
|
|
fallback = null;
|
|
|
|
if (value === null)
|
|
return fallback;
|
|
|
|
// Bitcoin Core compat.
|
|
if (typeof value === 'number') {
|
|
if (value === 1)
|
|
return true;
|
|
|
|
if (value === 0)
|
|
return false;
|
|
}
|
|
|
|
if (typeof value !== 'string') {
|
|
if (typeof value !== 'boolean')
|
|
throw new Error(`${fmt(key)} must be a boolean.`);
|
|
return value;
|
|
}
|
|
|
|
if (value === 'true' || value === '1')
|
|
return true;
|
|
|
|
if (value === 'false' || value === '0')
|
|
return false;
|
|
|
|
throw new Error(`${fmt(key)} must be a boolean.`);
|
|
}
|
|
|
|
/**
|
|
* Get a config option (as a buffer).
|
|
* @param {String} key
|
|
* @param {Object?} fallback
|
|
* @returns {Buffer|null}
|
|
*/
|
|
|
|
buf(key, fallback, enc) {
|
|
const value = this.get(key);
|
|
|
|
if (!enc)
|
|
enc = 'hex';
|
|
|
|
if (fallback === undefined)
|
|
fallback = null;
|
|
|
|
if (value === null)
|
|
return fallback;
|
|
|
|
if (typeof value !== 'string') {
|
|
if (!Buffer.isBuffer(value))
|
|
throw new Error(`${fmt(key)} must be a buffer.`);
|
|
return value;
|
|
}
|
|
|
|
const data = Buffer.from(value, enc);
|
|
|
|
if (data.length !== Buffer.byteLength(value, enc))
|
|
throw new Error(`${fmt(key)} must be a ${enc} string.`);
|
|
|
|
return data;
|
|
}
|
|
|
|
/**
|
|
* Get a config option (as an array of strings).
|
|
* @param {String} key
|
|
* @param {Object?} fallback
|
|
* @returns {String[]|null}
|
|
*/
|
|
|
|
array(key, fallback) {
|
|
const value = this.get(key);
|
|
|
|
if (fallback === undefined)
|
|
fallback = null;
|
|
|
|
if (value === null)
|
|
return fallback;
|
|
|
|
if (typeof value !== 'string') {
|
|
if (!Array.isArray(value))
|
|
throw new Error(`${fmt(key)} must be an array.`);
|
|
return value;
|
|
}
|
|
|
|
const parts = value.trim().split(/\s*,\s*/);
|
|
const result = [];
|
|
|
|
for (const part of parts) {
|
|
if (part.length === 0)
|
|
continue;
|
|
|
|
result.push(part);
|
|
}
|
|
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* Get a config option (as an object).
|
|
* @param {String} key
|
|
* @param {Object?} fallback
|
|
* @returns {Object|null}
|
|
*/
|
|
|
|
obj(key, fallback) {
|
|
const value = this.get(key);
|
|
|
|
if (fallback === undefined)
|
|
fallback = null;
|
|
|
|
if (value === null)
|
|
return fallback;
|
|
|
|
if (typeof value !== 'object' || Array.isArray(value))
|
|
throw new Error(`${fmt(key)} must be an object.`);
|
|
|
|
return value;
|
|
}
|
|
|
|
/**
|
|
* Get a config option (as a function).
|
|
* @param {String} key
|
|
* @param {Object?} fallback
|
|
* @returns {Function|null}
|
|
*/
|
|
|
|
func(key, fallback) {
|
|
const value = this.get(key);
|
|
|
|
if (fallback === undefined)
|
|
fallback = null;
|
|
|
|
if (value === null)
|
|
return fallback;
|
|
|
|
if (typeof value !== 'function')
|
|
throw new Error(`${fmt(key)} must be a function.`);
|
|
|
|
return value;
|
|
}
|
|
|
|
/**
|
|
* Get a config option (as a string).
|
|
* @param {String} key
|
|
* @param {Object?} fallback
|
|
* @returns {String|null}
|
|
*/
|
|
|
|
path(key, fallback) {
|
|
let value = this.str(key);
|
|
|
|
if (fallback === undefined)
|
|
fallback = null;
|
|
|
|
if (value === null)
|
|
return fallback;
|
|
|
|
if (value.length === 0)
|
|
return fallback;
|
|
|
|
switch (value[0]) {
|
|
case '~': // home dir
|
|
value = Path.join(HOME, value.substring(1));
|
|
break;
|
|
case '@': // prefix
|
|
value = Path.join(this.prefix, value.substring(1));
|
|
break;
|
|
default: // cwd
|
|
break;
|
|
}
|
|
|
|
return Path.normalize(value);
|
|
}
|
|
|
|
/**
|
|
* Get a config option (in MB).
|
|
* @param {String} key
|
|
* @param {Object?} fallback
|
|
* @returns {Number|null}
|
|
*/
|
|
|
|
mb(key, fallback) {
|
|
const value = this.uint(key);
|
|
|
|
if (fallback === undefined)
|
|
fallback = null;
|
|
|
|
if (value === null)
|
|
return fallback;
|
|
|
|
return value * 1024 * 1024;
|
|
}
|
|
|
|
/**
|
|
* Grab suffix from config data.
|
|
* @returns {String}
|
|
*/
|
|
|
|
getSuffix() {
|
|
if (!this.suffix)
|
|
throw new Error('No suffix presented.');
|
|
|
|
const suffix = this.str(this.suffix, this.fallback);
|
|
|
|
assert(isAlpha(suffix), 'Bad suffix.');
|
|
|
|
return suffix;
|
|
}
|
|
|
|
/**
|
|
* Grab prefix from config data.
|
|
* @private
|
|
* @returns {String}
|
|
*/
|
|
|
|
getPrefix() {
|
|
let prefix = this.str('prefix');
|
|
|
|
if (prefix) {
|
|
if (prefix[0] === '~')
|
|
prefix = Path.join(HOME, prefix.substring(1));
|
|
} else {
|
|
prefix = Path.join(HOME, `.${this.module}`);
|
|
}
|
|
|
|
if (this.suffix) {
|
|
const suffix = this.str(this.suffix);
|
|
|
|
if (suffix) {
|
|
assert(isAlpha(suffix), 'Bad suffix.');
|
|
if (this.fallback && suffix !== this.fallback)
|
|
prefix = Path.join(prefix, suffix);
|
|
}
|
|
}
|
|
|
|
return Path.normalize(prefix);
|
|
}
|
|
|
|
/**
|
|
* Grab config filename from config data.
|
|
* @private
|
|
* @param {String} file
|
|
* @returns {String}
|
|
*/
|
|
|
|
getFile(file) {
|
|
const name = this.str('config');
|
|
|
|
if (name)
|
|
return name;
|
|
|
|
return Path.join(this.prefix, file);
|
|
}
|
|
|
|
/**
|
|
* Create a file path using `prefix`.
|
|
* @param {String} file
|
|
* @returns {String}
|
|
*/
|
|
|
|
location(file) {
|
|
return Path.join(this.prefix, file);
|
|
}
|
|
|
|
/**
|
|
* Parse config text.
|
|
* @private
|
|
* @param {String} text
|
|
*/
|
|
|
|
parseConfig(text) {
|
|
assert(typeof text === 'string', 'Config must be text.');
|
|
|
|
if (text.charCodeAt(0) === 0xfeff)
|
|
text = text.substring(1);
|
|
|
|
text = text.replace(/\r\n/g, '\n');
|
|
text = text.replace(/\r/g, '\n');
|
|
text = text.replace(/\\\n/g, '');
|
|
|
|
let num = 0;
|
|
|
|
for (const chunk of text.split('\n')) {
|
|
const line = chunk.trim();
|
|
|
|
num += 1;
|
|
|
|
if (line.length === 0)
|
|
continue;
|
|
|
|
if (line[0] === '#')
|
|
continue;
|
|
|
|
const index = line.indexOf(':');
|
|
|
|
if (index === -1)
|
|
throw new Error(`Expected ':' on line ${num}: "${line}".`);
|
|
|
|
let key = line.substring(0, index).trim();
|
|
|
|
key = key.replace(/\-/g, '');
|
|
|
|
if (!isLowerKey(key))
|
|
throw new Error(`Invalid option on line ${num}: ${key}.`);
|
|
|
|
const value = line.substring(index + 1).trim();
|
|
|
|
if (value.length === 0)
|
|
continue;
|
|
|
|
const alias = this.alias[key];
|
|
|
|
if (alias)
|
|
key = alias;
|
|
|
|
this.data[key] = value;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Parse arguments.
|
|
* @private
|
|
* @param {Array?} argv
|
|
*/
|
|
|
|
parseArg(argv) {
|
|
if (!argv || typeof argv !== 'object')
|
|
argv = process.argv;
|
|
|
|
assert(Array.isArray(argv));
|
|
|
|
let last = null;
|
|
let pass = false;
|
|
|
|
for (let i = 2; i < argv.length; i++) {
|
|
const arg = argv[i];
|
|
|
|
assert(typeof arg === 'string');
|
|
|
|
if (arg === '--') {
|
|
pass = true;
|
|
continue;
|
|
}
|
|
|
|
if (pass) {
|
|
this.pass.push(arg);
|
|
continue;
|
|
}
|
|
|
|
if (arg.length === 0) {
|
|
last = null;
|
|
continue;
|
|
}
|
|
|
|
if (arg.indexOf('--') === 0) {
|
|
const index = arg.indexOf('=');
|
|
|
|
let key = null;
|
|
let value = null;
|
|
let empty = false;
|
|
|
|
if (index !== -1) {
|
|
// e.g. --opt=val
|
|
key = arg.substring(2, index);
|
|
value = arg.substring(index + 1);
|
|
last = null;
|
|
empty = false;
|
|
} else {
|
|
// e.g. --opt
|
|
key = arg.substring(2);
|
|
value = 'true';
|
|
last = null;
|
|
empty = true;
|
|
}
|
|
|
|
key = key.replace(/\-/g, '');
|
|
|
|
if (!isLowerKey(key))
|
|
throw new Error(`Invalid argument: --${key}.`);
|
|
|
|
if (value.length === 0)
|
|
continue;
|
|
|
|
// Do not allow one-letter aliases.
|
|
if (key.length > 1) {
|
|
const alias = this.alias[key];
|
|
if (alias)
|
|
key = alias;
|
|
}
|
|
|
|
this.args[key] = value;
|
|
|
|
if (empty)
|
|
last = key;
|
|
|
|
continue;
|
|
}
|
|
|
|
if (arg[0] === '-') {
|
|
// e.g. -abc
|
|
last = null;
|
|
|
|
for (let j = 1; j < arg.length; j++) {
|
|
let key = arg[j];
|
|
|
|
if ((key < 'a' || key > 'z')
|
|
&& (key < 'A' || key > 'Z')
|
|
&& (key < '0' || key > '9')
|
|
&& key !== '?') {
|
|
throw new Error(`Invalid argument: -${key}.`);
|
|
}
|
|
|
|
const alias = this.alias[key];
|
|
|
|
if (alias)
|
|
key = alias;
|
|
|
|
this.args[key] = 'true';
|
|
|
|
last = key;
|
|
}
|
|
|
|
continue;
|
|
}
|
|
|
|
// e.g. foo
|
|
const value = arg;
|
|
|
|
if (value.length === 0) {
|
|
last = null;
|
|
continue;
|
|
}
|
|
|
|
if (last) {
|
|
this.args[last] = value;
|
|
last = null;
|
|
} else {
|
|
this.argv.push(value);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Parse environment variables.
|
|
* @private
|
|
* @param {Object?} env
|
|
* @returns {Object}
|
|
*/
|
|
|
|
parseEnv(env) {
|
|
let prefix = this.module;
|
|
|
|
prefix = prefix.toUpperCase();
|
|
prefix = prefix.replace(/-/g, '_');
|
|
prefix += '_';
|
|
|
|
if (!env || typeof env !== 'object')
|
|
env = process.env;
|
|
|
|
assert(env && typeof env === 'object');
|
|
|
|
for (let key of Object.keys(env)) {
|
|
const value = env[key];
|
|
|
|
assert(typeof value === 'string');
|
|
|
|
if (key.indexOf(prefix) !== 0)
|
|
continue;
|
|
|
|
key = key.substring(prefix.length);
|
|
key = key.replace(/_/g, '');
|
|
|
|
if (!isUpperKey(key))
|
|
continue;
|
|
|
|
if (value.length === 0)
|
|
continue;
|
|
|
|
key = key.toLowerCase();
|
|
|
|
// Do not allow one-letter aliases.
|
|
if (key.length > 1) {
|
|
const alias = this.alias[key];
|
|
if (alias)
|
|
key = alias;
|
|
}
|
|
|
|
this.env[key] = value;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Parse uri querystring variables.
|
|
* @private
|
|
* @param {String} query
|
|
*/
|
|
|
|
parseQuery(query) {
|
|
if (typeof query !== 'string') {
|
|
if (!global.location)
|
|
return {};
|
|
|
|
query = global.location.search;
|
|
|
|
if (typeof query !== 'string')
|
|
return {};
|
|
}
|
|
|
|
return this.parseForm(query, '?', this.query);
|
|
}
|
|
|
|
/**
|
|
* Parse uri hash variables.
|
|
* @private
|
|
* @param {String} hash
|
|
*/
|
|
|
|
parseHash(hash) {
|
|
if (typeof hash !== 'string') {
|
|
if (!global.location)
|
|
return {};
|
|
|
|
hash = global.location.hash;
|
|
|
|
if (typeof hash !== 'string')
|
|
return {};
|
|
}
|
|
|
|
return this.parseForm(hash, '#', this.hash);
|
|
}
|
|
|
|
/**
|
|
* Parse form-urlencoded variables.
|
|
* @private
|
|
* @param {String} query
|
|
* @param {String} ch
|
|
* @param {Object} map
|
|
*/
|
|
|
|
parseForm(query, ch, map) {
|
|
assert(typeof query === 'string');
|
|
|
|
if (query.length === 0)
|
|
return;
|
|
|
|
if (query[0] === ch)
|
|
query = query.substring(1);
|
|
|
|
for (const pair of query.split('&')) {
|
|
const index = pair.indexOf('=');
|
|
|
|
let key, value;
|
|
if (index !== -1) {
|
|
key = pair.substring(0, index);
|
|
value = pair.substring(index + 1);
|
|
} else {
|
|
key = pair;
|
|
value = 'true';
|
|
}
|
|
|
|
key = unescape(key);
|
|
key = key.replace(/\-/g, '');
|
|
|
|
if (!isLowerKey(key))
|
|
continue;
|
|
|
|
value = unescape(value);
|
|
|
|
if (value.length === 0)
|
|
continue;
|
|
|
|
const alias = this.alias[key];
|
|
|
|
if (alias)
|
|
key = alias;
|
|
|
|
map[key] = value;
|
|
}
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Helpers
|
|
*/
|
|
|
|
function fmt(key) {
|
|
if (Array.isArray(key))
|
|
key = key[0];
|
|
|
|
if (typeof key === 'number')
|
|
return `Argument #${key}`;
|
|
|
|
return key;
|
|
}
|
|
|
|
function unescape(str) {
|
|
try {
|
|
str = decodeURIComponent(str);
|
|
str = str.replace(/\+/g, ' ');
|
|
} catch (e) {
|
|
;
|
|
}
|
|
str = str.replace(/\0/g, '');
|
|
return str;
|
|
}
|
|
|
|
function isAlpha(str) {
|
|
return /^[a-z0-9_\-]+$/i.test(str);
|
|
}
|
|
|
|
function isKey(key) {
|
|
return /^[a-zA-Z0-9]+$/.test(key);
|
|
}
|
|
|
|
function isLowerKey(key) {
|
|
if (!isKey(key))
|
|
return false;
|
|
|
|
return !/[A-Z]/.test(key);
|
|
}
|
|
|
|
function isUpperKey(key) {
|
|
if (!isKey(key))
|
|
return false;
|
|
|
|
return !/[a-z]/.test(key);
|
|
}
|
|
|
|
function _filter(name, a, b) {
|
|
for (const key of Object.keys(a)) {
|
|
if (key.length > name.length && key.indexOf(name) === 0) {
|
|
const sub = key.substring(name.length);
|
|
b[sub] = a[key];
|
|
}
|
|
}
|
|
}
|
|
|
|
function fromFloat(num, exp) {
|
|
assert(typeof num === 'number' && isFinite(num));
|
|
assert(Number.isSafeInteger(exp));
|
|
|
|
let str = num.toFixed(exp);
|
|
let sign = 1;
|
|
|
|
if (str.length > 0 && str[0] === '-') {
|
|
str = str.substring(1);
|
|
sign = -1;
|
|
}
|
|
|
|
let hi = str;
|
|
let lo = '0';
|
|
|
|
const index = str.indexOf('.');
|
|
|
|
if (index !== -1) {
|
|
hi = str.substring(0, index);
|
|
lo = str.substring(index + 1);
|
|
}
|
|
|
|
hi = hi.replace(/^0+/, '');
|
|
lo = lo.replace(/0+$/, '');
|
|
|
|
assert(hi.length <= 16 - exp,
|
|
'Fixed number string exceeds 2^53-1.');
|
|
|
|
assert(lo.length <= exp,
|
|
'Too many decimal places in fixed number string.');
|
|
|
|
if (hi.length === 0)
|
|
hi = '0';
|
|
|
|
while (lo.length < exp)
|
|
lo += '0';
|
|
|
|
if (lo.length === 0)
|
|
lo = '0';
|
|
|
|
assert(/^\d+$/.test(hi) && /^\d+$/.test(lo),
|
|
'Non-numeric characters in fixed number string.');
|
|
|
|
hi = parseInt(hi, 10);
|
|
lo = parseInt(lo, 10);
|
|
|
|
const mult = Math.pow(10, exp);
|
|
const maxLo = Number.MAX_SAFE_INTEGER % mult;
|
|
const maxHi = (Number.MAX_SAFE_INTEGER - maxLo) / mult;
|
|
|
|
assert(hi < maxHi || (hi === maxHi && lo <= maxLo),
|
|
'Fixed number string exceeds 2^53-1.');
|
|
|
|
return sign * (hi * mult + lo);
|
|
}
|
|
|
|
/*
|
|
* Expose
|
|
*/
|
|
|
|
module.exports = Config;
|