Newsworthy Presidential Mistakes
    Wondering what’s next for npm?Check out our public roadmap! »

    wirecloud-config-parser

    0.2.3 • Public • Published

    Node Wirecloud Config Parser

    Parser for a Wirecloud Mashable Application Component's config file.

    Getting started

    This parser can be installed via npm with this command:

    npm install wirecloud-config-parser --save

    Examples

    This parser takes an xml Wirecloud config file and returns a javascript object containing all data in it.

    Initialization

    Before trying to get any data, the library must be imported and the parser object created. There are two ways of creating a parser object. One is to pass a path as parameter to the constructor and the parser will read and parse the file indicated by the path:

    var Parser = require('wirecloud-config-parser');
    var configParser = new Parser('path/to/file');

    And the other is to give it an options object where you can specify either a path or directly the contents of a config file, as well as an option to validate the xml while building the object:

    var Parser = require('wirecloud-config-parser');
    var content = fs.readFileSync('path/to/file').toString();
    var configParser = new Parser({content: content, validate: true});

    NOTE: If you give both the path and the content options in the object the parser will read from the file given in the path

    Validate

    Whether you have validated the XML content while building the object or not, you can use the validate function later to test if the XML complies with Wirecloud's schema:

    configParser.validate();
    // it should return true or false

    NOTE: You can see all validation error that occurred in configParser.data.validationErrors.

    Retrieve data

    The data can be retrieved using the getData function:

    configParser.getData();

    This function returns an object containing the config file data:

    {
        name: 'some-name',
        vendor: 'some-vendor',
        version: '0.0.1',
        type: 'widget'
    }

    Contributing

    In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

    Release History

    (Nothing yet)

    Keywords

    none

    Install

    npm i wirecloud-config-parser

    DownloadsWeekly Downloads

    35

    Version

    0.2.3

    License

    Apache-2.0

    Unpacked Size

    13.1 kB

    Total Files

    9

    Last publish

    Collaborators

    • avatar