fast-xml-parser 3.20.3 → 4.0.0-beta.2

package/README.md

@@ -1,5 +1,3 @@
-
-
 # [fast-xml-parser](https://www.npmjs.com/package/fast-xml-parser)
 [![Backers on Open Collective](https://opencollective.com/fast-xml-parser/backers/badge.svg)](#backers) [![Sponsors on Open Collective](https://opencollective.com/fast-xml-parser/sponsors/badge.svg)](#sponsors) [![Known Vulnerabilities](https://snyk.io/test/github/naturalintelligence/fast-xml-parser/badge.svg)](https://snyk.io/test/github/naturalintelligence/fast-xml-parser)
 [![NPM quality][quality-image]][quality-url]
@@ -12,312 +10,125 @@
 [quality-url]: http://packagequality.com/#?package=fast-xml-parser
 
 
-Validate XML, Parse XML to JS/JSON and vice versa, or parse XML to Nimn rapidly without C/C++ based libraries and no callback
-
-To cover expenses, we're planning to launch [FXP Enterprise](https://github.com/NaturalIntelligence/fxp-ent) edition in parallel. Watch it for further updates, if you're interested.
-
-![Donate $5](static/img/donation_quote.png)
+Validate XML, Parse XML to JS Object, or Build XML from JS Object without C/C++ based libraries and no callback.
 
 <a href="https://opencollective.com/fast-xml-parser/donate" target="_blank">
   <img src="https://opencollective.com/fast-xml-parser/donate/button@2x.png?color=blue" width=200 />
 </a>
 <a href="https://paypal.me/naturalintelligence"> <img src="static/img/support_paypal.svg" alt="Stubmatic donate button" width="200"/></a>
 
+Check [ThankYouBackers](https://github.com/NaturalIntelligence/ThankYouBackers) for our contributors
+
 ## Users
-List of some applications/projects using Fast XML Parser. (Raise an issue to submit yours)
-
-<a href="https://github.com/NaturalIntelligence/imglab" title="imglab" ><img src="https://github.com/NaturalIntelligence/imglab/blob/master/img/imglab_logo.png?raw=true" width="80px" ></a>
-<a href="https://github.com/NaturalIntelligence/Stubmatic" title="stubmatic" ><img src="https://camo.githubusercontent.com/ff711425dc2286cd215637b7114eb43e571f001d/68747470733a2f2f6e61747572616c696e74656c6c6967656e63652e6769746875622e696f2f537475626d617469632f696d672f737475626d617469635f6c6f676f2e706e673f7261773d74727565" width="80px" ></a>
-<a href="https://github.com/muneem4node/muneem" title="Muneem" ><img src="https://github.com/muneem4node/muneem/raw/master/static/muneem.png?raw=true" width="80px" ></a>
-<a href="https://github.com/badges/shields" title="shields" ><img src="https://avatars2.githubusercontent.com/u/6254238" width="80px" ></a>
-<a href="https://github.com/renovatebot/renovate" title="renovate" ><img src="https://avatars1.githubusercontent.com/u/38656520" width="80px" ></a>
-<a href="https://vmware.com/" title="vmware" > <img src="https://avatars0.githubusercontent.com/u/473334" width="80px" ></a>
-<a href="https://opensource.microsoft.com/" title="microsoft" > <img src="https://avatars0.githubusercontent.com/u/6154722" width="80px" ></a>
-<a href="https://github.com/notable/notable" title="notable" > <img src="https://avatars3.githubusercontent.com/u/46467536" width="80px" ></a>
-<a href="http://ibm.github.io/" title="IBM" > <img src="https://avatars2.githubusercontent.com/u/1459110" width="80px" ></a>
-<a href="https://www.ft.com/" title="Financial Times" > <img src="https://avatars2.githubusercontent.com/u/3502508" width="80px" ></a>
-<a href="https://github.com/camunda" title="camunda BPM" > <img src="https://avatars3.githubusercontent.com/u/2443838" width="80px" ></a>
-<a href="https://github.com/AnyChart" title="AnyChart" > <img src="https://avatars0.githubusercontent.com/u/703373" width="80px" ></a>
-<a href="https://github.com/magda-io" title="magda-io" > <img src="https://avatars0.githubusercontent.com/u/40348684" width="80px" ></a>
-<a href="https://github.com/geistinteractive" title="Geist Interactive" > <img src="https://avatars0.githubusercontent.com/u/11617965" width="80px" ></a>
-<a href="https://www.tourstream.eu/" title="tourstream" > <img src="https://avatars1.githubusercontent.com/u/23242088" width="80px" ></a>
-<a href="https://www.atomist.com/" title="Atomist" > <img src="https://avatars3.githubusercontent.com/u/19392" width="80px" ></a>
-<a href="http://www.opuscapita.com/" title="OpusCapita" > <img src="https://avatars1.githubusercontent.com/u/23256480" width="80px" ></a>
-<a href="https://nevatrip.ru/" title="nevatrip" > <img src="https://avatars2.githubusercontent.com/u/35730984" width="80px" ></a>
-<a href="http://www.smartbear.com" title="SmartBear Software" > <img src="https://avatars2.githubusercontent.com/u/1644671" width="80px" ></a>
-<a href="http://eosnavigator.com/" title="nevatrip" > <img src="https://avatars1.githubusercontent.com/u/40260563" width="80px" ></a>
-<a href="http://nasa.github.io/" title="NASA" > <img src="https://avatars0.githubusercontent.com/u/848102" width="80px" ></a>
-<a href="http://qgis.org/" title="QGIS" > <img src="https://avatars2.githubusercontent.com/u/483444" width="80px" ></a>
-<a href="http://www.craft.ai/" title="craft ai" > <img src="https://avatars1.githubusercontent.com/u/12046764" width="80px" ></a>
-<a href="http://brownspace.org/" title="Brown Space Engineering" > <img src="https://avatars2.githubusercontent.com/u/5504507" width="80px" ></a>
-<a href="http://www.appcelerator.com/" title="Team Appcelerator" > <img src="https://avatars1.githubusercontent.com/u/82188" width="80px" ></a>
-<a href="https://xmllint.com/" title="XML Lint" > <img src="https://xmllint.com/assets/logo.png" width="80px" ></a>
-<a href="https://github.com/prettier" title="Prettier" > <img src="https://avatars0.githubusercontent.com/u/25822731" width="80px" ></a>
-<a href="https://github.com/dolanmiu/docx" title="docx" > <img src="https://i.imgur.com/37uBGhO.gif" width="80px" ></a>
-<a href="http://orange-opensource.github.io/" title="Open Source by Orange" > <img src="https://avatars3.githubusercontent.com/u/1506386" width="80px" ></a>
-<a href="http://www.ybrain.com/" title="YBRAIN Inc." > <img src="https://avatars2.githubusercontent.com/u/38232440" width="80px" ></a>
-<a href="http://99bitcoins.com/" title="99 bitcoins" > <img src="https://avatars0.githubusercontent.com/u/9527779" width="80px" ></a>
-<a href="https://wechaty.github.io/wechaty/" title="Wechaty" > <img src="https://avatars0.githubusercontent.com/u/21285357" width="80px" ></a>
-<a href="https://opendatakit.org" title="Open Data Kit" > <img src="https://avatars0.githubusercontent.com/u/6222985" width="80px" ></a>
-<a href="https://ridibooks.com" title="RIDI Books" > <img src="https://avatars1.githubusercontent.com/u/24955411" width="80px" ></a>
-<a href="http://signalk.org" title="Signal K" > <img src="https://avatars1.githubusercontent.com/u/7126740" width="80px" ></a>
-<a href="http://brain.js.org/" title="brain.js" > <img src="https://avatars2.githubusercontent.com/u/23732838" width="80px" ></a>
-<a href="https://skygear.io/" title="Skegear" > <img src="https://avatars1.githubusercontent.com/u/15025887" width="80px" ></a>
-<a href="https://npmjs.com/" title="npm" > <img src="https://avatars0.githubusercontent.com/u/6078720" width="80px" ></a>
-<a href=" https://www.mindpointgroup.com" title="mindpointgroup" > <img src="https://avatars1.githubusercontent.com/u/6413533" width="80px" ></a>
-<a href="http://www.acuantcorp.com/" title="Acuant Inc" > <img src="https://avatars3.githubusercontent.com/u/11580319?s=200&v=4" width="80px" ></a>
-<a href="https://www.wazuh.com/" title="wazuh" > <img src="https://avatars2.githubusercontent.com/u/13752566" width="80px" ></a>
-<a href="https://orbs.com/" title="ORBS The Hybrid Blockchain" > <img src="https://avatars1.githubusercontent.com/u/33665977" width="80px" ></a>
-<a href="https://texlab.netlify.com/" title="latex-lsp" > <img src="https://avatars1.githubusercontent.com/u/48360002" width="80px" ></a>
-<a href="https://frontside.io/" title="The Frontside " > <img src="https://avatars1.githubusercontent.com/u/223096" width="80px" ></a>
-<a href="https://creditsense.com.au/" title="Credit Sense Australia " > <img src="https://avatars0.githubusercontent.com/u/46947118" width="80px" ></a>
-<a href="https://www.hustunique.com/" title="UniqueStudio" > <img src="https://avatars1.githubusercontent.com/u/4847684" width="80px" ></a>
-<a href="http://www.openforis.org/" title="Open Foris" > <img src="https://avatars2.githubusercontent.com/u/1212750" width="80px" ></a>
-<a href="#" title="NHS Connect" > <img src="https://avatars3.githubusercontent.com/u/20316669" width="80px" ></a>
-<a href="https://tradle.io/" title="Tradle" > <img src="https://avatars2.githubusercontent.com/u/9482126" width="80px" ></a>
-<a href="http://www.anl.gov/" title="Argonne National Laboratory" > <img src="https://avatars0.githubusercontent.com/u/10468712" width="80px" ></a>
-<a href="https://simpleicons.org/" title="Simple Icons" > <img src="https://avatars2.githubusercontent.com/u/29872746" width="80px" ></a>
-<a href="https://stoplight.io/" title="Stoplight" > <img src="https://avatars1.githubusercontent.com/u/10767217" width="80px" ></a>
-<a href="http://www.fda.gov/" title="Food and Drug Administration " > <img src="https://avatars2.githubusercontent.com/u/6471964" width="80px" ></a>
-<a href="http://www.magento.com/" title="Magento" > <img src="https://avatars2.githubusercontent.com/u/168457" width="80px" ></a>
-
-
-The list of users is collected either from the list published by Github, cummunicated directly through mails/chat , or from other resources. If you feel that your name in the above list is incorrectly published or you're not the user of this library anymore then you can inform us to remove it. We'll do the necessary changes ASAP.
+
+<a href="https://github.com/renovatebot/renovate" title="renovate" ><img src="https://avatars1.githubusercontent.com/u/38656520" width="60px" ></a>
+<a href="https://vmware.com/" title="vmware" > <img src="https://avatars0.githubusercontent.com/u/473334" width="60px" ></a>
+<a href="https://opensource.microsoft.com/" title="microsoft" > <img src="https://avatars0.githubusercontent.com/u/6154722" width="60px" ></a>
+<a href="http://ibm.github.io/" title="IBM" > <img src="https://avatars2.githubusercontent.com/u/1459110" width="60px" ></a>
+<a href="http://www.smartbear.com" title="SmartBear Software" > <img src="https://avatars2.githubusercontent.com/u/1644671" width="60px" ></a>
+<a href="http://nasa.github.io/" title="NASA" > <img src="https://avatars0.githubusercontent.com/u/848102" width="60px" ></a>
+<a href="https://github.com/prettier" title="Prettier" > <img src="https://avatars0.githubusercontent.com/u/25822731" width="60px" ></a>
+<a href="http://brain.js.org/" title="brain.js" > <img src="https://avatars2.githubusercontent.com/u/23732838" width="60px" ></a>
+<a href="#" title="NHS Connect" > <img src="https://avatars3.githubusercontent.com/u/20316669" width="60px" ></a>
+<a href="http://www.fda.gov/" title="Food and Drug Administration " > <img src="https://avatars2.githubusercontent.com/u/6471964" width="60px" ></a>
+<a href="http://www.magento.com/" title="Magento" > <img src="https://avatars2.githubusercontent.com/u/168457" width="60px" ></a>
+
+Check the list of all known users [here](./USERs.md);
+
+<small>The list of users is collected either from the list published by Github, cummunicated directly through mails/chat , or from other resources. If you feel that your name in the above list is incorrectly published or you're not the user of this library anymore then you can inform us to remove it. We'll do the necessary changes ASAP.</small>
 
 ### Main Features
 
 <img align="right" src="static/img/fxp_logo.png" width="180px" alt="FXP logo"/>
 
 * Validate XML data syntactically
-* Transform XML to JSON or Nimn
-* Transform JSON back to XML
+* Parse XML to JS Object
+* Build XML from JS Object
 * Works with node packages, in browser, and in CLI (press try me button above for demo)
 * Faster than any pure JS implementation.
 * It can handle big files (tested up to 100mb).
-* Various options are available to customize the transformation
-    * You can parse CDATA as a separate property.
-    * You can prefix attributes or group them to a separate property. Or they can be ignored from the result completely.
-    * You can parse tag's or attribute's value to primitive type: string, integer, float, hexadecimal, or boolean. And can optionally decode for HTML char.
-    * You can remove namespace from tag or attribute name while parsing
-    * It supports boolean attributes, if configured.
+* Controlled parsing using various options
 
 ## How to use
 
-To use it in **NPM package**  install it first
-
-`$npm install fast-xml-parser` or using [yarn](https://yarnpkg.com/) `$yarn add fast-xml-parser`
+To use as package dependency
+`$ npm install fast-xml-parser` 
+or 
+`$ yarn add fast-xml-parser`
 
-To use it from a **CLI** install it globally with the `-g` option.
-
-`$npm install fast-xml-parser -g`
+To use as system command
+`$ npm install fast-xml-parser -g` 
 
 To use it on a **webpage** include it from a [CDN](https://cdnjs.com/libraries/fast-xml-parser)
 
-### XML to JSON
-
-
-```js
-var jsonObj = parser.parse(xmlData [,options] );
-```
-
-```js
-var parser = require('fast-xml-parser');
-var he = require('he');
-
-var options = {
-    attributeNamePrefix : "@_",
-    attrNodeName: "attr", //default is 'false'
-    textNodeName : "#text",
-    ignoreAttributes : true,
-    ignoreNameSpace : false,
-    allowBooleanAttributes : false,
-    parseNodeValue : true,
-    parseAttributeValue : false,
-    trimValues: true,
-    cdataTagName: "__cdata", //default is 'false'
-    cdataPositionChar: "\\c",
-    parseTrueNumberOnly: false,
-    numParseOptions:{
-      hex: true,
-      leadingZeros: true,
-      //skipLike: /\+[0-9]{10}/
-    }
-    arrayMode: false, //"strict"
-    attrValueProcessor: (val, attrName) => he.decode(val, {isAttributeValue: true}),//default is a=>a
-    tagValueProcessor : (val, tagName) => he.decode(val), //default is a=>a
-    stopNodes: ["parse-me-as-string"]
-};
-
-if( parser.validate(xmlData) === true) { //optional (it'll return an object in case it's not valid)
-    var jsonObj = parser.parse(xmlData,options);
-}
-
-// Intermediate obj
-var tObj = parser.getTraversalObj(xmlData,options);
-var jsonObj = parser.convertToJson(tObj,options);
-
-```
-As you can notice in the above code, validator is not embedded with in the parser and expected to be called separately. However, you can pass `true` or validation options as 3rd parameter to the parser to trigger validator internally. It is same as above example.
-
-```js
-try{
-  var jsonObj = parser.parse(xmlData,options, true);
-}catch(error){
-  console.log(error.message)
-}
-```
-
-Validator returns the following object in case of error;
-```js
-{
-  err: {
-    code: code,
-    msg: message,
-    line: lineNumber,
-  },
-};
-```
-
-
-#### Note: [he](https://www.npmjs.com/package/he) library is used in this example
-
-<details>
-	<summary>OPTIONS :</summary>
-
-* **attributeNamePrefix** : prepend given string to attribute name for identification
-* **attrNodeName**: (Valid name) Group all the attributes as properties of given name.
-* **ignoreAttributes** : Ignore attributes to be parsed.
-* **ignoreNameSpace** : Remove namespace string from tag and attribute names.
-* **allowBooleanAttributes** : a tag can have attributes without any value
-* **parseNodeValue** : Parse the value of text node to float, integer, or boolean.
-* **parseAttributeValue** : Parse the value of an attribute to float, integer, or boolean.
-* **trimValues** : trim string values of an attribute or node
-* **decodeHTMLchar** : This options has been removed from 3.3.4. Instead, use tagValueProcessor, and attrValueProcessor. See above example.
-* **cdataTagName** : If specified, parser parse CDATA as nested tag instead of adding it's value to parent tag.
-* **cdataPositionChar** : It'll help to covert JSON back to XML without losing CDATA position.
-* **parseTrueNumberOnly**: if true then values like "+123", or "0123" will not be parsed as number.
-* **arrayMode** : When `false`, a tag with single occurrence is parsed as an object but as an array in case of multiple occurences. When `true`, a tag will be parsed as an array always excluding leaf nodes. When `strict`, all the tags will be parsed as array only. When instance of `RegEx`, only tags will be parsed as array that match the regex. When `function` a tag name is passed to the callback that can be checked.
-* **tagValueProcessor** : Process tag value during transformation. Like HTML decoding, word capitalization, etc. Applicable in case of string only.
-* **attrValueProcessor** : Process attribute value during transformation. Like HTML decoding, word capitalization, etc. Applicable in case of string only.
-* **stopNodes** : an array of tag names which are not required to be parsed. Instead their values are parsed as string.
-
-</details>
-
-<details>
-	<summary>To use from <b>command line</b></summary>
+**Example**
 
+As CLI command
 ```bash
-$xml2js [-ns|-a|-c|-v|-V] <filename> [-o outputfile.json]
-$cat xmlfile.xml | xml2js [-ns|-a|-c|-v|-V] [-o outputfile.json]
+$ fxparser some.xml
 ```
 
-* -ns : To include namespaces (by default ignored)
-* -a : To ignore attributes
-* -c : To ignore value conversion (i.e. "-3" will not be converted to number -3)
-* -v : validate before parsing
-* -V : only validate
-</details>
-
-
-<details>
-	<summary>To use it <b>on webpage</b></summary>
-
+In a node js project
 ```js
-var result = parser.validate(xmlData);
-if (result !== true) console.log(result.err);
-var jsonObj = parser.parse(xmlData);
-```
-</details>
+const { XMLParser, XMLBuilder, XMLValidator} = require("../src/fxp");
 
-### JSON / JS Object to XML
+const parser = new XMLParser();
+let jObj = parser.parse(XMLdata);
 
-```js
-var Parser = require("fast-xml-parser").j2xParser;
-//default options need not to set
-var defaultOptions = {
-    attributeNamePrefix : "@_",
-    attrNodeName: "@", //default is false
-    textNodeName : "#text",
-    ignoreAttributes : true,
-    cdataTagName: "__cdata", //default is false
-    cdataPositionChar: "\\c",
-    format: false,
-    indentBy: "  ",
-    supressEmptyNode: false,
-    tagValueProcessor: a=> he.encode(a, { useNamedReferences: true}),// default is a=>a
-    attrValueProcessor: a=> he.encode(a, {isAttributeValue: isAttribute, useNamedReferences: true})// default is a=>a
-};
-var parser = new Parser(defaultOptions);
-var xml = parser.parse(json_or_js_obj);
+const builder = new XMLBuilder();
+const xmlContent = builder.build(jObj);
 ```
 
-<details>
-	<summary>OPTIONS :</summary>
-
-With the correct options, you can get the almost original XML without losing any information.
-
-* **attributeNamePrefix** : Identify attributes with this prefix otherwise treat them as a tag.
-* **attrNodeName**: Identify attributes when they are grouped under single property.
-* **ignoreAttributes** : Don't check for attributes. Treats everything as tag.
-* **encodeHTMLchar** : This option has been removed from 3.3.4. Use tagValueProcessor, and attrValueProcessor instead. See above example.
-* **cdataTagName** : If specified, parse matching tag as CDATA
-* **cdataPositionChar** : Identify the position where CDATA tag should be placed. If it is blank then CDATA will be added in the last of tag's value.
-* **format** : If set to true, then format the XML output.
-* **indentBy** : indent by this char `when` format is set to `true`
-* **supressEmptyNode** : If set to `true`, tags with no value (text or nested tags) are written as self closing tags.
-* **tagValueProcessor** : Process tag value during transformation. Like HTML encoding, word capitalization, etc. Applicable in case of string only.
-* **attrValueProcessor** : Process attribute value during transformation. Like HTML encoding, word capitalization, etc. Applicable in case of string only.
-</details>
-
-## Benchmark
-
-#### XML to JSON
-
-![npm_xml2json_compare](static/img/fxpv3-vs-xml2jsv0419_chart.png)
-
-<details>
-	<summary>report</summary>
+In a HTML page
+```html
+<script src="path/to/fxparser.js"></script>
+:
+<script>
+  const parser = new fxparser.XMLParser();
+  parser.parse(xmlContent);
+</script>
+```
 
-| file size | fxp 3.0 validator (rps) | fxp 3.0 parser (rps) | xml2js 0.4.19 (rps) |
-| ---------- | ----------------------- | ------------------- | ------------------- |
-| 1.5k | 16581.06758 | 14032.09323 | 4615.930805 |
-| 1.5m | 14918.47793 | 13.23366098 | 5.90682005 |
-| 13m | 1.834479235 | 1.135582008 | -1 |
-| 1.3k with CDATA | 30583.35319 | 43160.52342 | 8398.556349 |
-| 1.3m with CDATA | 27.29266471 | 52.68877009 | 7.966000795 |
-| 1.6k with cdata,prolog,doctype | 27690.26082 | 41433.98547 | 7872.399268 |
-| 98m | 0.08473858148 | 0.2600104004 | -1 |
+### Documents
+**v3**
+* [documents](./docs/v3/docs.md)
 
-* -1 indicates error or incorrect output.
-</details>
+**v4**
+1. [GettingStarted.md](./docs/v4/1.GettingStarted.md)
+2.  [XML Parser](./docs/v4/2.XMLparseOptions.md)
+3.  [XML Builder](./docs/v4/3.XMLBuilder.md)
+4.  [XML Validator](./docs/v4/4.XMLValidator.md)
 
+## Performance
 
-#### JSON to XML
+### XML Parser
 
-![npm_xml2json_compare](static/img/j2x.png)
+![](./docs/imgs/XMLParser_v4.png)
 
-<details>
-	<summary>report</summary>
+**Large files**
+![](./docs/imgs/XMLParser_large_v4.png)
 
-| file size | fxp 3.2 js to xml | xml2js 0.4.19 builder |
-|------------|-----------------|-----------------|
-| 1.3k | 160148.9801 | 10384.99401|
-| 1.1m | 173.6374831 | 8.611884025|
+### XML Builder
 
-</details>
+![](./docs/imgs/XMLBuilder_v4.png)
 
-### Worth to mention
+<small>negative means error</small>
 
-- **[BigBit standard)](https://github.com/amitguptagwl/bigbit)** : A standard to represent any number in the universe in comparatively less space and without precision loss. A standard to save memory to represent any text string in comparision of UTF encodings.
-- **[imglab](https://github.com/NaturalIntelligence/imglab)** : Speedup and simplify image labeling / annotation. Supports multiple formats, one click annotation, easy interface and much more. There are more than half million images are being annotated every month using this tool.
-- [stubmatic](https://github.com/NaturalIntelligence/Stubmatic) : Create fake webservices, DynamoDB or S3 servers, Manage fake/mock stub data, Or fake any HTTP(s) call.
-- **[अनुमार्गक (anumargak)](https://github.com/NaturalIntelligence/anumargak)** : The fastest and simple router for node js web frameworks with many unique features.
-- [मुनीम (Muneem)](https://github.com/muneem4node/muneem) : A webframework made for all team members. Fast and Featured.
-- [शब्दावली (shabdawali)](https://github.com/amitguptagwl/shabdawali) : Amazing human like typing effects beyond your imagination.
+## Our other projects and research you must try
 
+* **[BigBit standard](https://github.com/amitguptagwl/bigbit)** : 
+  * Single text encoding to replace UTF-8, UTF-16, UTF-32 and more with less memory.
+  * Single Numeric datatype alternative of integer, float, double, long, decimal and more without precision loss.
+* **[Cytorus](https://github.com/NaturalIntelligence/cytorus)**: Now be specific and flexible while running E2E tests.
+  * Run tests only for a particular User Story
+  * Run tests for a route or from a route
+  * Customizable reporting
+  * Central dashboard for better monitoring
+* **[Stubmatic](https://github.com/NaturalIntelligence/Stubmatic)** : Create fake webservices, DynamoDB or S3 servers, Manage fake/mock stub data, Or fake any HTTP(s) call.
 
 
-## Contributors
+## Supporters
+### Contributors
 
 This project exists thanks to [all](graphs/contributors) the people who contribute. [[Contribute](docs/CONTRIBUTING.md)].
 <!-- <a href="graphs/contributors"><img src="https://opencollective.com/fast-xml-parser/contributors.svg?width=890&button=false" /></a> -->
@@ -329,16 +140,16 @@ This project exists thanks to [all](graphs/contributors) the people who contribu
 ### All Contributors -->
 <a href="graphs/contributors"><img src="https://opencollective.com/fast-xml-parser/contributors.svg?width=890&button=false" /></a>
 
-## Backers
+### Backers
 
 Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/fast-xml-parser#backer)]
 
 <a href="https://opencollective.com/fast-xml-parser#backers" target="_blank"><img src="https://opencollective.com/fast-xml-parser/backers.svg?width=890"></a>
 
 
-## Sponsors
+### Sponsors
 
-Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/fast-xml-parser#sponsor)]
+<small>[[Become a sponsor](https://opencollective.com/fast-xml-parser#sponsor)] Support this project by becoming a sponsor. Your logo will show up here with a link to your website. Please also share your detail so we can thankyou on SocialMedia.</small>
 
 <a href="https://opencollective.com/fast-xml-parser/sponsor/0/website" target="_blank"><img src="https://opencollective.com/fast-xml-parser/sponsor/0/avatar.svg"></a>
 <a href="https://opencollective.com/fast-xml-parser/sponsor/1/website" target="_blank"><img src="https://opencollective.com/fast-xml-parser/sponsor/1/avatar.svg"></a>
@@ -352,5 +163,6 @@ Support this project by becoming a sponsor. Your logo will show up here with a l
 <a href="https://opencollective.com/fast-xml-parser/sponsor/9/website" target="_blank"><img src="https://opencollective.com/fast-xml-parser/sponsor/9/avatar.svg"></a>
 
 # License
-
 * MIT License
+
+![Donate $5](static/img/donation_quote.png)

package/package.json

@@ -1,22 +1,21 @@
 {
   "name": "fast-xml-parser",
-  "version": "3.20.3",
-  "description": "Validate XML or Parse XML to JS/JSON very fast without C/C++ based libraries",
-  "main": "./src/parser.js",
+  "version": "4.0.0-beta.2",
+  "description": "Validate XML, Parse XML, Build XML without C/C++ based libraries",
+  "main": "./src/fxp.js",
   "scripts": {
-    "test": "jasmine spec/*spec.js",
+    "test": "nyc --reporter=lcov --reporter=text jasmine spec/*spec.js",
     "unit": "jasmine",
+    "coverage": "nyc report --reporter html --reporter text -t .nyc_output --report-dir .nyc_output/summary",
     "perf": "node ./benchmark/perfTest3.js",
     "lint": "eslint src/*.js spec/*.js",
     "bundle": "webpack && webpack --config webpack-prod.config.js",
-    "coverage": "istanbul cover -x \"cli.js\" -x \"spec/*spec.js\" jasmine spec/*spec.js;",
-    "coverage:check": "istanbul check-coverage --branch 90 --statement 90",
     "prettier": "prettier --write src/**/*.js",
     "publish-please": "publish-please",
-    "prepublishOnly": "publish-please guard"
+    "checkReadiness": "publish-please --dry-run"
   },
   "bin": {
-    "xml2js": "./cli.js"
+    "fxparser": "./src/cli/cli.js"
   },
   "repository": {
     "type": "git",
@@ -31,42 +30,16 @@
     "x2js",
     "xml2json",
     "js",
-    "traversable",
     "cli",
-    "command",
     "validator",
     "validate",
     "transformer",
-    "checker",
     "assert",
-    "big",
     "js2xml",
     "json2xml",
-    "nimn",
-    "xml2nimn",
-    "locale",
     "html"
   ],
   "author": "Amit Gupta (https://amitkumargupta.work/)",
-  "contributors": [
-    {
-      "name": "Alfonso Muñoz-Pomer Fuentes",
-      "email": "amunoz@ebi.ac.uk",
-      "url": "https://github.com/alfonsomunozpomer"
-    },
-    {
-      "name": "Steve Reichenbach",
-      "url": "https://github.com/EyesOnlyNet"
-    },
-    {
-      "name": "Vohmyanin Sergey Vasilevich",
-      "url": "http://delagen.livejournal.com"
-    },
-    {
-      "name": "Andrew Udvare",
-      "url": "https://github.com/Tatsh"
-    }
-  ],
   "license": "MIT",
   "devDependencies": {
     "@babel/core": "^7.13.10",
@@ -76,16 +49,14 @@
     "babel-loader": "^8.2.2",
     "eslint": "^5.16.0",
     "he": "^1.2.0",
-    "http-server": "^0.12.3",
-    "istanbul": "^0.4.5",
     "jasmine": "^3.6.4",
-    "nimnjs": "^1.3.2",
+    "nyc": "^15.1.0",
     "prettier": "^1.19.1",
     "publish-please": "^5.5.2",
     "webpack": "^4.46.0",
     "webpack-cli": "^3.3.12"
   },
-  "typings": "src/parser.d.ts",
+  "typings": "src/fxp.d.ts",
   "funding": {
     "type": "paypal",
     "url": "https://paypal.me/naturalintelligence"

package/{cli.js → src/cli/cli.js}

@@ -3,26 +3,19 @@
 /*eslint-disable no-console*/
 const fs = require('fs');
 const path = require('path');
-const parser = require('./src/parser');
-const readToEnd = require('./src/read').readToEnd;
+const {XMLParser, XMLValidator} = require("../fxp");
+const readToEnd = require('./read').readToEnd;
 
+const version = require('./../../package.json').version;
 if (process.argv[2] === '--help' || process.argv[2] === '-h') {
-  console.log('Fast XML Parser ' + require(path.join(__dirname + '/package.json')).version);
-  console.log('----------------');
-  console.log('xml2js [-ns|-a|-c|-v|-V] <filename> [-o outputfile.json]');
-  console.log('cat xmlfile.xml | xml2js [-ns|-a|-c|-v|-V] [-o outputfile.json]');
-  console.log('-ns: remove namespace from tag and atrribute name.');
-  console.log("-a: don't parse attributes.");
-  console.log('-c: parse values to premitive type.');
-  console.log('-v: validate before parsing.');
-  console.log('-V: validate only.');
+  console.log(require("./man"));
 } else if (process.argv[2] === '--version') {
-  console.log(require(path.join(__dirname + '/package.json')).version);
+  console.log(version);
 } else {
   const options = {
-    ignoreNameSpace: true,
+    removeNSPrefix: true,
     ignoreAttributes: false,
-    parseNodeValue: true,
+    parseTagValue: true,
     parseAttributeValue: true,
   };
   let fileName = '';
@@ -31,11 +24,11 @@ if (process.argv[2] === '--help' || process.argv[2] === '-h') {
   let validateOnly = false;
   for (let i = 2; i < process.argv.length; i++) {
     if (process.argv[i] === '-ns') {
-      options.ignoreNameSpace = false;
+      options.removeNSPrefix = false;
     } else if (process.argv[i] === '-a') {
       options.ignoreAttributes = true;
     } else if (process.argv[i] === '-c') {
-      options.parseNodeValue = false;
+      options.parseTagValue = false;
       options.parseAttributeValue = false;
     } else if (process.argv[i] === '-o') {
       outputFileName = process.argv[++i];
@@ -48,20 +41,18 @@ if (process.argv[2] === '--help' || process.argv[2] === '-h') {
       fileName = process.argv[i];
     }
   }
+  
   const callback = function(xmlData) {
     let output = '';
     if (validate) {
-      const result = parser.validate(xmlData);
-      if (result === true) {
-        output = JSON.stringify(parser.parse(xmlData, options), null, 4);
-      } else {
-        output = result;
-      }
+      const parser = new XMLParser(options);
+      output = parser.parse(xmlData,validate);
     } else if (validateOnly) {
-      output = parser.validate(xmlData);
+      output = XMLValidator.validate(xmlData);
       process.exitCode = output === true ? 0 : 1;
     } else {
-      output = JSON.stringify(parser.parse(xmlData, options), null, 4);
+      const parser = new XMLParser(options);
+      output = JSON.stringify(parser.parse(xmlData,validate), null, 4);
     }
     if (outputFileName) {
       writeToFile(outputFileName, output);
@@ -71,6 +62,7 @@ if (process.argv[2] === '--help' || process.argv[2] === '-h') {
   };
 
   try {
+    
     if (!fileName) {
       readToEnd(process.stdin, function(err, data) {
         if (err) {

package/src/cli/man.js

@@ -0,0 +1,12 @@
+module.exports = `Fast XML Parser 4.0.0
+----------------
+$ fxparser [-ns|-a|-c|-v|-V] <filename> [-o outputfile.json]
+$ cat xmlfile.xml | fxparser [-ns|-a|-c|-v|-V] [-o outputfile.json]
+
+Options
+----------------
+-ns: remove namespace from tag and atrribute name.
+-a: don't parse attributes.
+-c: parse values to premitive type.
+-v: validate before parsing.
+-V: validate only.`