Home

Awesome

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

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:
Fallbacks:x: