@node9/proxy 1.12.7 → 1.12.8

package/node_modules/mvdan-sh/LICENSE

@@ -0,0 +1,27 @@
+Copyright (c) 2016, Daniel Martí. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+   * Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+   * Redistributions in binary form must reproduce the above
+copyright notice, this list of conditions and the following disclaimer
+in the documentation and/or other materials provided with the
+distribution.
+   * Neither the name of the copyright holder nor the names of its
+contributors may be used to endorse or promote products derived from
+this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/node_modules/mvdan-sh/README.md

@@ -0,0 +1,84 @@
+## mvdan-sh
+
+This package is a JavaScript version of a shell package written in Go, available
+at https://github.com/mvdan/sh.
+
+It is transpiled from Go to JS using https://github.com/gopherjs/gopherjs.
+
+### Sample usage
+
+```
+const sh = require('mvdan-sh')
+const syntax = sh.syntax
+
+var parser = syntax.NewParser()
+var printer = syntax.NewPrinter()
+
+var src = "echo 'foo'"
+var f = parser.Parse(src, "src.sh")
+
+// print out the syntax tree
+syntax.DebugPrint(f)
+console.log()
+
+// replace all single quoted string values
+syntax.Walk(f, function(node) {
+        if (syntax.NodeType(node) == "SglQuoted") {
+                node.Value = "bar"
+        }
+        return true
+})
+
+// print the code back out
+console.log(printer.Print(f)) // echo 'bar'
+```
+
+You can find more samples in
+[testmain.js](https://github.com/mvdan/sh/blob/master/_js/testmain.js).
+
+### Available APIs
+
+The APIs listed below are wrapped to be usable in JavaScript. Follow the links
+to read their documentation.
+
+* [syntax.NewParser](https://pkg.go.dev/mvdan.cc/sh/v3/syntax#NewParser)
+  - [Parser.Parse](https://pkg.go.dev/mvdan.cc/sh/v3/syntax#Parser.Parse)
+  - [Parser.Interactive](https://pkg.go.dev/mvdan.cc/sh/v3/syntax#Parser.Interactive)
+  - [Parser.Incomplete](https://pkg.go.dev/mvdan.cc/sh/v3/syntax#Parser.Incomplete)
+* [syntax.DebugPrint](https://pkg.go.dev/mvdan.cc/sh/v3/syntax#DebugPrint)
+* [syntax.Walk](https://pkg.go.dev/mvdan.cc/sh/v3/syntax#Walk)
+* [syntax.NewPrinter](https://pkg.go.dev/mvdan.cc/sh/v3/syntax#NewPrinter)
+  - [Printer.Print](https://pkg.go.dev/mvdan.cc/sh/v3/syntax#Printer.Print)
+
+Constructor options like
+[syntax.KeepComments](https://pkg.go.dev/mvdan.cc/sh/v3/syntax#KeepComments) are
+also available.
+
+The original `io.Reader` parameters can take a string or a
+[stream.Readable](https://nodejs.org/api/stream.html#stream_class_stream_readable)
+object. `io.Writer` parameters are replaced by string returns.
+
+The nodes you will find in the syntax tree are all equivalent to the nodes you
+will see on the Go API. To get the type of a node, use `syntax.NodeType` as the
+example above shows. Some of the most common node types include:
+
+* [syntax.File](https://pkg.go.dev/mvdan.cc/sh/v3/syntax#File)
+* [syntax.Stmt](https://pkg.go.dev/mvdan.cc/sh/v3/syntax#Stmt)
+* [syntax.CallExpr](https://pkg.go.dev/mvdan.cc/sh/v3/syntax#CallExpr)
+* [syntax.Word](https://pkg.go.dev/mvdan.cc/sh/v3/syntax#Word)
+* [syntax.Lit](https://pkg.go.dev/mvdan.cc/sh/v3/syntax#Lit)
+
+The five above will show up in your syntax tree if you parse a `echo foo`
+command, which you can see if you use `syntax.DebugPrint` to inspect the syntax
+tree.
+
+### Building
+
+You will need:
+
+* Latest Go 1.17.x
+* NodeJS, to run the `testmain.js` test suite
+
+Then, simply run `./build`. The result will be `index.js`, which isn't minified.
+At the time of writing, `index.js` weighs 1.7MiB in plaintext, and 220KiB when
+minified and gzipped.