parse-string-data

Parse data (object literal / array) from a text string and return a data structure

This is particularly useful for extracting data from a text string, that doesnt conform to the JSON spec and will fail when using JSON.parse. e.g. data stored as a javascript object, without quotes surrounding the key:value pairs

The NPM distribution is shipped with the following files:

• index.js: Babel transpiled version for general use
• index.es6.js - Original ES6 version for platforms that support ES6

Installing

Run the following from your projects' root folder to install and save as a dependency in your package.json

npm install parse-string-data --save

Syntax

parseStringData(str[,initialValue])

Parameters

str (string) A string containing your data

initialValue (Object|Array) An initial value for your data to be assigned to.

( You must be sure of what data you are retrieving to use this parameter. e.g. if your data is an object, ensure you are passing through an object. Ditto for Array.)

Usage

Firstly, lets create a string containing some data, and require the module

var parseStringData = require('parse-string-data');
var str = 'Lorem ipsum dolor sit amet, consectetur adiplising elit. { foo: true, bar: false, buzz: bla }';

Call the module with the string as it's first argument.

var parsedData = parseStringData(str);

The data in the above string will be extracted and returned in a data structure. In this case, an Object.

{
 foo: true,
 bar: false,
 buzz: 'bla'
}

Recursion

When parsing the results, parse-string-data recursively checks the extracted value for data, allowing the data to be many levels deep

var str = 'Lorem ipsum dolor sit amet, consectetur adiplising elit. { foo: true, bar: false, buzz: [0, 10, asdf], beer: { type: paleale, size: pint, favourite: true, sizes: [pot, schooner, pint]  }  }';

Parsing the above string will result in the following:

{
  foo: true,
  bar: false,
  buzz: [
    0: 0, 
    1: 10, 
    2: 'asdf'
  ],
  beer: { 
    type: paleale,
    favourite: true,
    size: pint, 
    sizes: [
      0: 'pot', 
      1: 'schooner', 
      2: 'pint'
    ]
  }
}

Using an Initial Value

When invoking the function, an Initial Value can be used via it's 2nd argument. This is useful for merging with existing data or overwriting defaults.

var data = {
  lorem: 'ipsum',
  dolor: 'sit amet'
};
var merged = parseStringData(str, data);

The above returns the following

{
  lorem: 'ipsum',
  dolor: 'sit amet',
  foo: true,
  bar: false,
  buzz: 'bla'
}

Extending your projects' defaults

var defaults = {
  foo: true,
  bar: true,
  buzz: 'asdf'
}

var settings = parseStringData(str, defaults);

Settings now results in the following:

{
 foo: true,
 bar: false,
 buzz: 'bla'
}

Data Formatting

During parsing, the data values are run through a formatter to avoid returning values as strings. e.g.

• 'true' and 'false' are formatted as Boolean
• '0', '10', '-1' are formatted as a Number
• 'null' is formatted as a null Object.

Additional formatting can be submitted by a pull-request.

Contributing

Please read CONTRIBUTING.md for details on the process for submitting pull requests.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

License

This project is licensed under the MIT License - see the LICENSE.md file for details