projen 0.98.32 → 0.98.34

package/node_modules/{xmlbuilder2/node_modules/js-yaml → js-yaml}/README.md

@@ -1,14 +1,14 @@
 JS-YAML - YAML 1.2 parser / writer for JavaScript
 =================================================
 
-[![Build Status](https://travis-ci.org/nodeca/js-yaml.svg?branch=master)](https://travis-ci.org/nodeca/js-yaml)
+[![CI](https://github.com/nodeca/js-yaml/workflows/CI/badge.svg?branch=master)](https://github.com/nodeca/js-yaml/actions)
 [![NPM version](https://img.shields.io/npm/v/js-yaml.svg)](https://www.npmjs.org/package/js-yaml)
 
-__[Online Demo](http://nodeca.github.com/js-yaml/)__
+__[Online Demo](https://nodeca.github.io/js-yaml/)__
 
 
-This is an implementation of [YAML](http://yaml.org/), a human-friendly data
-serialization language. Started as [PyYAML](http://pyyaml.org/) port, it was
+This is an implementation of [YAML](https://yaml.org/), a human-friendly data
+serialization language. Started as [PyYAML](https://pyyaml.org/) port, it was
 completely rewritten from scratch. Now it's very fast, and supports 1.2 spec.
 
 
@@ -46,38 +46,12 @@ Optional arguments:
 ```
 
 
-### Bundled YAML library for browsers
-
-``` html
-<!-- esprima required only for !!js/function -->
-<script src="esprima.js"></script>
-<script src="js-yaml.min.js"></script>
-<script type="text/javascript">
-var doc = jsyaml.load('greeting: hello\nname: world');
-</script>
-```
-
-Browser support was done mostly for the online demo. If you find any errors - feel
-free to send pull requests with fixes. Also note, that IE and other old browsers
-needs [es5-shims](https://github.com/kriskowal/es5-shim) to operate.
-
-Notes:
-
-1. We have no resources to support browserified version. Don't expect it to be
-   well tested. Don't expect fast fixes if something goes wrong there.
-2. `!!js/function` in browser bundle will not work by default. If you really need
-   it - load `esprima` parser first (via amd or directly).
-3. `!!bin` in browser will return `Array`, because browsers do not support
-   node.js `Buffer` and adding Buffer shims is completely useless on practice.
-
-
 API
 ---
 
 Here we cover the most 'useful' methods. If you need advanced details (creating
-your own tags), see [wiki](https://github.com/nodeca/js-yaml/wiki) and
-[examples](https://github.com/nodeca/js-yaml/tree/master/examples) for more
-info.
+your own tags), see [examples](https://github.com/nodeca/js-yaml/tree/master/examples)
+for more info.
 
 ``` javascript
 const yaml = require('js-yaml');
@@ -85,7 +59,7 @@ const fs   = require('fs');
 
 // Get document, or throw exception on error
 try {
-  const doc = yaml.safeLoad(fs.readFileSync('/home/ixti/example.yml', 'utf8'));
+  const doc = yaml.load(fs.readFileSync('/home/ixti/example.yml', 'utf8'));
   console.log(doc);
 } catch (e) {
   console.log(e);
@@ -93,11 +67,11 @@ try {
 ```
 
 
-### safeLoad (string [ , options ])
+### load (string [ , options ])
 
-**Recommended loading way.** Parses `string` as single YAML document. Returns either a
-plain object, a string or `undefined`, or throws `YAMLException` on error. By default, does
-not support regexps, functions and undefined. This method is safe for untrusted data.
+Parses `string` as single YAML document. Returns either a
+plain object, a string, a number, `null` or `undefined`, or throws `YAMLException` on error. By default, does
+not support regexps, functions and undefined.
 
 options:
 
@@ -105,17 +79,14 @@ options:
   error/warning messages.
 - `onWarning` _(default: null)_ - function to call on warning messages.
   Loader will call this function with an instance of `YAMLException` for each warning.
-- `schema` _(default: `DEFAULT_SAFE_SCHEMA`)_ - specifies a schema to use.
+- `schema` _(default: `DEFAULT_SCHEMA`)_ - specifies a schema to use.
   - `FAILSAFE_SCHEMA` - only strings, arrays and plain objects:
-    http://www.yaml.org/spec/1.2/spec.html#id2802346
+    https://www.yaml.org/spec/1.2/spec.html#id2802346
   - `JSON_SCHEMA` - all JSON-supported types:
-    http://www.yaml.org/spec/1.2/spec.html#id2803231
+    https://www.yaml.org/spec/1.2/spec.html#id2803231
   - `CORE_SCHEMA` - same as `JSON_SCHEMA`:
-    http://www.yaml.org/spec/1.2/spec.html#id2804923
-  - `DEFAULT_SAFE_SCHEMA` - all supported YAML types, without unsafe ones
-    (`!!js/undefined`, `!!js/regexp` and `!!js/function`):
-    http://yaml.org/type/
-  - `DEFAULT_FULL_SCHEMA` - all supported YAML types.
+    https://www.yaml.org/spec/1.2/spec.html#id2804923
+  - `DEFAULT_SCHEMA` - all supported YAML types.
 - `json` _(default: false)_ - compatibility with JSON.parse behaviour. If true, then duplicate keys in a mapping will override values rather than throwing an error.
 
 NOTE: This function **does not** understand multi-document sources, it throws
@@ -127,43 +98,23 @@ It allows numbers in any notation, use `Null` and `NULL` as `null`, etc.
 The core schema also has no such restrictions. It allows binary notation for integers.
 
 
-### load (string [ , options ])
-
-**Use with care with untrusted sources**. The same as `safeLoad()` but uses
-`DEFAULT_FULL_SCHEMA` by default - adds some JavaScript-specific types:
-`!!js/function`, `!!js/regexp` and `!!js/undefined`. For untrusted sources, you
-must additionally validate object structure to avoid injections:
-
-``` javascript
-const untrusted_code = '"toString": !<tag:yaml.org,2002:js/function> "function (){very_evil_thing();}"';
-
-// I'm just converting that string, what could possibly go wrong?
-require('js-yaml').load(untrusted_code) + ''
-```
+### loadAll (string [, iterator] [, options ])
 
-
-### safeLoadAll (string [, iterator] [, options ])
-
-Same as `safeLoad()`, but understands multi-document sources. Applies
+Same as `load()`, but understands multi-document sources. Applies
 `iterator` to each document if specified, or returns array of documents.
 
 ``` javascript
 const yaml = require('js-yaml');
 
-yaml.safeLoadAll(data, function (doc) {
+yaml.loadAll(data, function (doc) {
   console.log(doc);
 });
 ```
 
 
-### loadAll (string [, iterator] [ , options ])
-
-Same as `safeLoadAll()` but uses `DEFAULT_FULL_SCHEMA` by default.
-
-
-### safeDump (object [ , options ])
+### dump (object [ , options ])
 
-Serializes `object` as a YAML document. Uses `DEFAULT_SAFE_SCHEMA`, so it will
+Serializes `object` as a YAML document. Uses `DEFAULT_SCHEMA`, so it will
 throw an exception if you try to dump regexps or functions. However, you can
 disable exceptions by setting the `skipInvalid` option to `true`.
 
@@ -173,17 +124,20 @@ options:
 - `noArrayIndent` _(default: false)_ - when true, will not add an indentation level to array elements
 - `skipInvalid` _(default: false)_ - do not throw on invalid types (like function
   in the safe schema) and skip pairs and single values with such types.
-- `flowLevel` (default: -1) - specifies level of nesting, when to switch from
+- `flowLevel` _(default: -1)_ - specifies level of nesting, when to switch from
   block to flow style for collections. -1 means block style everwhere
 - `styles` - "tag" => "style" map. Each tag may have own set of styles.
-- `schema` _(default: `DEFAULT_SAFE_SCHEMA`)_ specifies a schema to use.
+- `schema` _(default: `DEFAULT_SCHEMA`)_ specifies a schema to use.
 - `sortKeys` _(default: `false`)_ - if `true`, sort keys when dumping YAML. If a
   function, use the function to sort the keys.
-- `lineWidth` _(default: `80`)_ - set max line width.
+- `lineWidth` _(default: `80`)_ - set max line width. Set `-1` for unlimited width.
 - `noRefs` _(default: `false`)_ - if `true`, don't convert duplicate objects into references
 - `noCompatMode` _(default: `false`)_ - if `true` don't try to be compatible with older
   yaml versions. Currently: don't quote "yes", "no" and so on, as required for YAML 1.1
 - `condenseFlow` _(default: `false`)_ - if `true` flow sequences will be condensed, omitting the space between `a, b`. Eg. `'[a,b]'`, and omitting the space between `key: value` and quoting the key. Eg. `'{"a":b}'` Can be useful when using yaml for pretty URL query params as spaces are %-encoded.
+- `quotingType` _(`'` or `"`, default: `'`)_ - strings will be quoted using this quoting style. If you specify single quotes, double quotes will still be used for non-printable characters.
+- `forceQuotes` _(default: `false`)_ - if `true`, all non-key strings will be quoted even if they normally don't need to.
+- `replacer` - callback `function (key, value)` called recursively on each key/value in source object (see `replacer` docs for `JSON.stringify`).
 
 The following table show availlable styles (e.g. "canonical",
 "binary"...) available for each tag (.e.g. !!null, !!int ...). Yaml
@@ -195,10 +149,11 @@ output is shown on the right side after `=>` (default setting) or `->`:
   "lowercase"   => "null"
   "uppercase"   -> "NULL"
   "camelcase"   -> "Null"
+  "empty"       -> ""
 
 !!int
   "binary"      -> "0b1", "0b101010", "0b1110001111010"
-  "octal"       -> "01", "052", "016172"
+  "octal"       -> "0o1", "0o52", "0o16172"
   "decimal"     => "1", "42", "7290"
   "hexadecimal" -> "0x1", "0x2A", "0x1C7A"
 
@@ -216,7 +171,7 @@ output is shown on the right side after `=>` (default setting) or `->`:
 Example:
 
 ``` javascript
-safeDump (object, {
+dump(object, {
   'styles': {
     '!!null': 'canonical' // dump null as ~
   },
@@ -224,17 +179,12 @@ safeDump (object, {
 });
 ```
 
-### dump (object [ , options ])
-
-Same as `safeDump()` but without limits (uses `DEFAULT_FULL_SCHEMA` by default).
-
-
 Supported YAML types
 --------------------
 
-The list of standard YAML tags and corresponding JavaScipt types. See also
-[YAML tag discussion](http://pyyaml.org/wiki/YAMLTagDiscussion) and
-[YAML types repository](http://yaml.org/type/).
+The list of standard YAML tags and corresponding JavaScript types. See also
+[YAML tag discussion](https://pyyaml.org/wiki/YAMLTagDiscussion) and
+[YAML types repository](https://yaml.org/type/).
 
 ```
 !!null ''                   # null
@@ -253,11 +203,9 @@ The list of standard YAML tags and corresponding JavaScipt types. See also
 
 **JavaScript-specific tags**
 
-```
-!!js/regexp /pattern/gim            # RegExp
-!!js/undefined ''                   # Undefined
-!!js/function 'function () {...}'   # Function
-```
+See [js-yaml-js-types](https://github.com/nodeca/js-yaml-js-types) for
+extra types.
+
 
 Caveats
 -------

package/node_modules/{xmlbuilder2/node_modules/js-yaml → js-yaml}/bin/js-yaml.js

@@ -6,16 +6,9 @@
 /*eslint-disable no-console*/
 
 
-// stdlib
-var fs    = require('fs');
-
-
-// 3rd-party
+var fs       = require('fs');
 var argparse = require('argparse');
-
-
-// internal
-var yaml = require('..');
+var yaml     = require('..');
 
 
 ////////////////////////////////////////////////////////////////////////////////
@@ -23,42 +16,43 @@ var yaml = require('..');
 
 var cli = new argparse.ArgumentParser({
   prog:     'js-yaml',
-  version:  require('../package.json').version,
-  addHelp:  true
+  add_help:  true
 });
 
+cli.add_argument('-v', '--version', {
+  action: 'version',
+  version: require('../package.json').version
+});
 
-cli.addArgument([ '-c', '--compact' ], {
+cli.add_argument('-c', '--compact', {
   help:   'Display errors in compact mode',
-  action: 'storeTrue'
+  action: 'store_true'
 });
 
-
 // deprecated (not needed after we removed output colors)
 // option suppressed, but not completely removed for compatibility
-cli.addArgument([ '-j', '--to-json' ], {
-  help:   argparse.Const.SUPPRESS,
+cli.add_argument('-j', '--to-json', {
+  help:   argparse.SUPPRESS,
   dest:   'json',
-  action: 'storeTrue'
+  action: 'store_true'
 });
 
-
-cli.addArgument([ '-t', '--trace' ], {
+cli.add_argument('-t', '--trace', {
   help:   'Show stack trace on error',
-  action: 'storeTrue'
+  action: 'store_true'
 });
 
-cli.addArgument([ 'file' ], {
+cli.add_argument('file', {
   help:   'File to read, utf-8 encoded without BOM',
   nargs:  '?',
-  defaultValue: '-'
+  default: '-'
 });
 
 
 ////////////////////////////////////////////////////////////////////////////////
 
 
-var options = cli.parseArgs();
+var options = cli.parse_args();
 
 
 ////////////////////////////////////////////////////////////////////////////////