Giter VIP home page Giter VIP logo

node-libxml's Introduction

Node-LibXML

For old node.js versions please use verison < 4.0.0 Already for old LTS node (4,6,8) npm install [email protected];

For new node.js versions (10,12,14) we are using n-api so please install npm install [email protected] (4.0.0 is not working)

Node-Libxml is a LibXML2 Node.js Wrapper

It can perform:

  • Wellformed check & rerror report
  • Validity against DTD/XSD(Schema) check,
  • Get doctype informations (about dtd)
  • GetXpath Values
  • Load XMl from string or file path

Requirements:

Node-Libxml has nos any dependencies, it's fully bundled, so you can just use it as it comes :)

Works on : Linux, Osx & Windows (no 32bits, just 64 bits)

Why use it

Node-libxml has been thought differently than libxmljs; whereas libxmljs can be use in commun uses, you can use node-libxml if:

  • You wan to validate against DTD (libxmljs can't)
  • You want a silent program if xml is not wellformed (node-libxml returns wellformed error in object; libxmljs throws)
  • You want to do xml processing in parallel forks
  • You want to load XML from file path OR string
  • You want to validate against DTD / schema on multiple documents with just ONE dtd/schema loaded in memory (libxmljs loads it on each validation request), so it's clearly by far fastest!

Install

  npm i node-libxml

Use

  const Libxml = require('node-libxml');
  let libxml = new Libxml();

  let xmlIsWellformed = libxml.loadXml('path/to/xml');
  let xmlIsWellformedStr = libxml.loadXmlFromString('<name>test</name>');

  console.log(xmlIsWellformed);
  console.log(libxml.wellformedErrors);

  console.log(libxml.getDtd());

  libxml.loadDtds(['path/to/dtd1', 'path/to/dtd2']);
  let xmlIsValid = libxml.validateAgainstDtds();
  console.log(xmlIsValid);
  console.log(libxml.validationDtdErrors);

  //Get some xpaths;
  let aRandomPathBoolean = libxml.xpathSelect('boolean(//some/path'));
  let aRandomPathNumber = libxml.xpathSelect('number(//some/path'));
  let countSomeElements = libxml.xpathSelect('count(//some/path'));
  //... & all xpath could do I think

check tests for more examples

API

Loading functions

loadXml(string)

A function of libxml to load the XML file TAKE a path & RETURN true if wellformed | false if not SET a an array 'wellformedErrors' in libxml element containing wellformed errors

loadXmlFromString(string)

A function of libxml to create the xml Dom from a string TAKE a string containing xml & RETURN true if wellformed | false if not SET a an array 'wellformedErrors' in libxml element containing wellformed errors

loadDtds(array)

A function of libxml to load the DTDs files TAKE an array of path of & RETURN nothing SET a an array 'dtdsLoadedErrors' in libxml element IF error happend on loading dtd(s)

loadSchemas(array)

A function of libxml to load the XSDs files TAKE an array of path of & RETURN nothing SET a an array 'schemasLoadedErrors' in libxml element IF error happend on loading xsd(s) ex

Validating functions

validateAgainstDtd()

A function of libxml to validate against the previously loaded DTD(s) TAKE nothing & RETURN a string which is the name of the first dtd which has validated RETURN false if no dtd(s) have validate the xml RETURN null if no any dtd have been corectly loaded SET a an array 'validationDtdErrors' in libxml element if no dtd has validate

validateAgainstSchemas()

A function of libxml to validate against the previously loaded DTD(s) TAKE nothing & RETURN a string which is the name of the first dtd which has validated RETURN false if no dtd(s) have validate the xml RETURN null if no any schema have been corectly loaded SET a an array 'validationDtdErrors' in libxml element if no dtd has validate

Get informations of the the XML

getDtd()

A function of libxml to evaluate the xpath on the previously loaded XML TAKE nothin & RETURN an object containing name,externalId & systemId

xpathSelect(string)

A function of libxml to evaluate the xpath on the previously loaded XML TAKE string & RETURN value depending on what you asked (number, boolean..) RETURN null if no match ex

Memory management

Use those functions when you have finished jobs of elements, or before overwrite them. ex

freeXml()

A function of libxml to free XML memory file TAKE nothing & RETURN nothin FREE memory & clear 'wellformedErrors' property on libxml instance

freeDtds()

A function of libxml to free all the DTD in memory TAKE nothing & RETURN nothin FREE memory & clear 'dtdsLoadedErrors' property on libxml instance FREE memory & clear 'validationDtdErrors' property on libxml instance

freeSchemas()

A function of libxml to free all the Schema in memory TAKE nothing & RETURN nothin FREE memory & clear 'schemasLoadedErrors' property on libxml instance FREE memory & clear 'validationSchemaErrors' property on libxml instance

clearAll()

A function of libxml to free all the memory taken by libxml2 TAKE nothing & RETURN nothin free all memory in all instance in all fork using by libxml.

Contribute

Install

  • npm i
  • then move the build-tmp-napi-*{anyversionyougot} as -> mv build-tmp-napi-v7 build (for the moment I did not found how to build directly to buiuld forlder with pre-gyp for n-api)
  • npm test should pass 😎

Important notes

Travis & appveyor cannot be used anymore with n-api because auto-publish from node-pre-gyp-github not working anymore + we have now n release for one node version

node-libxml's People

Contributors

matthd avatar glibas avatar nagyjano avatar trollkotze avatar mrothenbuecher avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.