aboutsummaryrefslogtreecommitdiff
path: root/node_modules/ini
diff options
context:
space:
mode:
Diffstat (limited to 'node_modules/ini')
-rw-r--r--node_modules/ini/LICENSE15
-rw-r--r--node_modules/ini/README.md102
-rw-r--r--node_modules/ini/ini.js206
-rw-r--r--node_modules/ini/package.json36
4 files changed, 359 insertions, 0 deletions
diff --git a/node_modules/ini/LICENSE b/node_modules/ini/LICENSE
new file mode 100644
index 0000000..19129e3
--- /dev/null
+++ b/node_modules/ini/LICENSE
@@ -0,0 +1,15 @@
+The ISC License
+
+Copyright (c) Isaac Z. Schlueter and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
diff --git a/node_modules/ini/README.md b/node_modules/ini/README.md
new file mode 100644
index 0000000..33df258
--- /dev/null
+++ b/node_modules/ini/README.md
@@ -0,0 +1,102 @@
+An ini format parser and serializer for node.
+
+Sections are treated as nested objects. Items before the first
+heading are saved on the object directly.
+
+## Usage
+
+Consider an ini-file `config.ini` that looks like this:
+
+ ; this comment is being ignored
+ scope = global
+
+ [database]
+ user = dbuser
+ password = dbpassword
+ database = use_this_database
+
+ [paths.default]
+ datadir = /var/lib/data
+ array[] = first value
+ array[] = second value
+ array[] = third value
+
+You can read, manipulate and write the ini-file like so:
+
+ var fs = require('fs')
+ , ini = require('ini')
+
+ var config = ini.parse(fs.readFileSync('./config.ini', 'utf-8'))
+
+ config.scope = 'local'
+ config.database.database = 'use_another_database'
+ config.paths.default.tmpdir = '/tmp'
+ delete config.paths.default.datadir
+ config.paths.default.array.push('fourth value')
+
+ fs.writeFileSync('./config_modified.ini', ini.stringify(config, { section: 'section' }))
+
+This will result in a file called `config_modified.ini` being written
+to the filesystem with the following content:
+
+ [section]
+ scope=local
+ [section.database]
+ user=dbuser
+ password=dbpassword
+ database=use_another_database
+ [section.paths.default]
+ tmpdir=/tmp
+ array[]=first value
+ array[]=second value
+ array[]=third value
+ array[]=fourth value
+
+
+## API
+
+### decode(inistring)
+
+Decode the ini-style formatted `inistring` into a nested object.
+
+### parse(inistring)
+
+Alias for `decode(inistring)`
+
+### encode(object, [options])
+
+Encode the object `object` into an ini-style formatted string. If the
+optional parameter `section` is given, then all top-level properties
+of the object are put into this section and the `section`-string is
+prepended to all sub-sections, see the usage example above.
+
+The `options` object may contain the following:
+
+* `section` A string which will be the first `section` in the encoded
+ ini data. Defaults to none.
+* `whitespace` Boolean to specify whether to put whitespace around the
+ `=` character. By default, whitespace is omitted, to be friendly to
+ some persnickety old parsers that don't tolerate it well. But some
+ find that it's more human-readable and pretty with the whitespace.
+
+For backwards compatibility reasons, if a `string` options is passed
+in, then it is assumed to be the `section` value.
+
+### stringify(object, [options])
+
+Alias for `encode(object, [options])`
+
+### safe(val)
+
+Escapes the string `val` such that it is safe to be used as a key or
+value in an ini-file. Basically escapes quotes. For example
+
+ ini.safe('"unsafe string"')
+
+would result in
+
+ "\"unsafe string\""
+
+### unsafe(val)
+
+Unescapes the string `val`
diff --git a/node_modules/ini/ini.js b/node_modules/ini/ini.js
new file mode 100644
index 0000000..7d05a71
--- /dev/null
+++ b/node_modules/ini/ini.js
@@ -0,0 +1,206 @@
+const { hasOwnProperty } = Object.prototype
+
+const eol = typeof process !== 'undefined' &&
+ process.platform === 'win32' ? '\r\n' : '\n'
+
+const encode = (obj, opt) => {
+ const children = []
+ let out = ''
+
+ if (typeof opt === 'string') {
+ opt = {
+ section: opt,
+ whitespace: false,
+ }
+ } else {
+ opt = opt || Object.create(null)
+ opt.whitespace = opt.whitespace === true
+ }
+
+ const separator = opt.whitespace ? ' = ' : '='
+
+ for (const k of Object.keys(obj)) {
+ const val = obj[k]
+ if (val && Array.isArray(val)) {
+ for (const item of val)
+ out += safe(k + '[]') + separator + safe(item) + '\n'
+ } else if (val && typeof val === 'object')
+ children.push(k)
+ else
+ out += safe(k) + separator + safe(val) + eol
+ }
+
+ if (opt.section && out.length)
+ out = '[' + safe(opt.section) + ']' + eol + out
+
+ for (const k of children) {
+ const nk = dotSplit(k).join('\\.')
+ const section = (opt.section ? opt.section + '.' : '') + nk
+ const { whitespace } = opt
+ const child = encode(obj[k], {
+ section,
+ whitespace,
+ })
+ if (out.length && child.length)
+ out += eol
+
+ out += child
+ }
+
+ return out
+}
+
+const dotSplit = str =>
+ str.replace(/\1/g, '\u0002LITERAL\\1LITERAL\u0002')
+ .replace(/\\\./g, '\u0001')
+ .split(/\./)
+ .map(part =>
+ part.replace(/\1/g, '\\.')
+ .replace(/\2LITERAL\\1LITERAL\2/g, '\u0001'))
+
+const decode = str => {
+ const out = Object.create(null)
+ let p = out
+ let section = null
+ // section |key = value
+ const re = /^\[([^\]]*)\]$|^([^=]+)(=(.*))?$/i
+ const lines = str.split(/[\r\n]+/g)
+
+ for (const line of lines) {
+ if (!line || line.match(/^\s*[;#]/))
+ continue
+ const match = line.match(re)
+ if (!match)
+ continue
+ if (match[1] !== undefined) {
+ section = unsafe(match[1])
+ if (section === '__proto__') {
+ // not allowed
+ // keep parsing the section, but don't attach it.
+ p = Object.create(null)
+ continue
+ }
+ p = out[section] = out[section] || Object.create(null)
+ continue
+ }
+ const keyRaw = unsafe(match[2])
+ const isArray = keyRaw.length > 2 && keyRaw.slice(-2) === '[]'
+ const key = isArray ? keyRaw.slice(0, -2) : keyRaw
+ if (key === '__proto__')
+ continue
+ const valueRaw = match[3] ? unsafe(match[4]) : true
+ const value = valueRaw === 'true' ||
+ valueRaw === 'false' ||
+ valueRaw === 'null' ? JSON.parse(valueRaw)
+ : valueRaw
+
+ // Convert keys with '[]' suffix to an array
+ if (isArray) {
+ if (!hasOwnProperty.call(p, key))
+ p[key] = []
+ else if (!Array.isArray(p[key]))
+ p[key] = [p[key]]
+ }
+
+ // safeguard against resetting a previously defined
+ // array by accidentally forgetting the brackets
+ if (Array.isArray(p[key]))
+ p[key].push(value)
+ else
+ p[key] = value
+ }
+
+ // {a:{y:1},"a.b":{x:2}} --> {a:{y:1,b:{x:2}}}
+ // use a filter to return the keys that have to be deleted.
+ const remove = []
+ for (const k of Object.keys(out)) {
+ if (!hasOwnProperty.call(out, k) ||
+ typeof out[k] !== 'object' ||
+ Array.isArray(out[k]))
+ continue
+
+ // see if the parent section is also an object.
+ // if so, add it to that, and mark this one for deletion
+ const parts = dotSplit(k)
+ let p = out
+ const l = parts.pop()
+ const nl = l.replace(/\\\./g, '.')
+ for (const part of parts) {
+ if (part === '__proto__')
+ continue
+ if (!hasOwnProperty.call(p, part) || typeof p[part] !== 'object')
+ p[part] = Object.create(null)
+ p = p[part]
+ }
+ if (p === out && nl === l)
+ continue
+
+ p[nl] = out[k]
+ remove.push(k)
+ }
+ for (const del of remove)
+ delete out[del]
+
+ return out
+}
+
+const isQuoted = val =>
+ (val.charAt(0) === '"' && val.slice(-1) === '"') ||
+ (val.charAt(0) === "'" && val.slice(-1) === "'")
+
+const safe = val =>
+ (typeof val !== 'string' ||
+ val.match(/[=\r\n]/) ||
+ val.match(/^\[/) ||
+ (val.length > 1 &&
+ isQuoted(val)) ||
+ val !== val.trim())
+ ? JSON.stringify(val)
+ : val.replace(/;/g, '\\;').replace(/#/g, '\\#')
+
+const unsafe = (val, doUnesc) => {
+ val = (val || '').trim()
+ if (isQuoted(val)) {
+ // remove the single quotes before calling JSON.parse
+ if (val.charAt(0) === "'")
+ val = val.substr(1, val.length - 2)
+
+ try {
+ val = JSON.parse(val)
+ } catch (_) {}
+ } else {
+ // walk the val to find the first not-escaped ; character
+ let esc = false
+ let unesc = ''
+ for (let i = 0, l = val.length; i < l; i++) {
+ const c = val.charAt(i)
+ if (esc) {
+ if ('\\;#'.indexOf(c) !== -1)
+ unesc += c
+ else
+ unesc += '\\' + c
+
+ esc = false
+ } else if (';#'.indexOf(c) !== -1)
+ break
+ else if (c === '\\')
+ esc = true
+ else
+ unesc += c
+ }
+ if (esc)
+ unesc += '\\'
+
+ return unesc.trim()
+ }
+ return val
+}
+
+module.exports = {
+ parse: decode,
+ decode,
+ stringify: encode,
+ encode,
+ safe,
+ unsafe,
+}
diff --git a/node_modules/ini/package.json b/node_modules/ini/package.json
new file mode 100644
index 0000000..59b7d5d
--- /dev/null
+++ b/node_modules/ini/package.json
@@ -0,0 +1,36 @@
+{
+ "author": "Isaac Z. Schlueter <i@izs.me> (http://blog.izs.me/)",
+ "name": "ini",
+ "description": "An ini encoder/decoder for node",
+ "version": "2.0.0",
+ "repository": {
+ "type": "git",
+ "url": "git://github.com/isaacs/ini.git"
+ },
+ "main": "ini.js",
+ "scripts": {
+ "eslint": "eslint",
+ "lint": "npm run eslint -- ini.js test/*.js",
+ "lintfix": "npm run lint -- --fix",
+ "test": "tap",
+ "posttest": "npm run lint",
+ "preversion": "npm test",
+ "postversion": "npm publish",
+ "prepublishOnly": "git push origin --follow-tags"
+ },
+ "devDependencies": {
+ "eslint": "^7.9.0",
+ "eslint-plugin-import": "^2.22.0",
+ "eslint-plugin-node": "^11.1.0",
+ "eslint-plugin-promise": "^4.2.1",
+ "eslint-plugin-standard": "^4.0.1",
+ "tap": "14"
+ },
+ "license": "ISC",
+ "files": [
+ "ini.js"
+ ],
+ "engines": {
+ "node": ">=10"
+ }
+}
© Floofi Systems, Some rights reserved. Powered by cgit.