1.0.1 • Published 7 years ago

hocon-parser v1.0.1

Weekly downloads
513
License
ISC
Repository
github
Last release
7 years ago

Travis Build Status

HoconJS

This is a very basic Hocon parser written in JavaScript.

It does almost no validation whatsoever but can create an object from most hocon files.

Please feel free to contribute with PRs.

This module is intended to work in the browser and nodejs.

Browser usage :

<script type="text/javascript" src="/node_modules/hocon-parser/hocon.min.js"></script>
<script type="text/javascript">
    var obj = parseHocon(someHoconText);
</script>

NodeJS :

var parseHocon = require('hocon-parser');
var obj = parseHocon(someHoconText);

Scripts

  • Installing : npm install hocon-parser
  • Running tests : npm test
  • Building source : npm run release

Example Output

Input Hocon string:

  myConfig.cool.numb: 5
  myConfig.cool.stuff: {
     x : quotesarebadmmkay
     z : {
       yes: 'no not really'
     }
  }
  myConfig.cool.stuff { z { no='yes yes really' } }
  myConfig.dupe: ${myConfig.cool.stuff.x}
  meinarr [2,3, {x:haha}]
  meinobj {hocon: issoweirdman}
  notherobj : ${meinobj.hocon}

Output object:

{
  "myConfig": {
    "cool": {
      "numb": 5,
      "stuff": {
        "x": "quotesarebadmmkay",
        "z": {
          "yes": "no not really",
          "no": "yes yes really"
        }
      }
    },
    "dupe": "quotesarebadmmkay"
  },
  "meinarr": [2, 3, {
    "x": "haha"
  }],
  "meinobj": {
    "hocon": "issoweirdman"
  },
  "notherobj": "issoweirdman"
}

Features

FeatureCompletionExample
Objects:white_check_mark:myKey { myOtherKey: 'myValue' }
Arrays:white_check_mark:myKey [1,2,3,4]
Comments:white_check_mark:// some comment # some comment
= and : Separators:white_check_mark:myKey='myValue'
Unquoted Strings:white_check_mark:myKey: myString
Multiline Strings ("""):white_check_mark:myKey: """what's happening"""
Path Expressions:white_check_mark:myRoot.myKey.someKey : 4
Substitutions:white_check_mark:myKey: $(myRoot.myKey)
String Concatenation in Arrays:white_check_mark:myArr: [hello there]
Objects Merging:x:
Value Concatenation:x:
include:x: