cson

CSON

CoffeeScript-Object-Notation Parser. Same as JSON but for CoffeeScript objects.

What is CSON?

Everyone knows JSON, it's the thing that looks like this:

{
	"abc": [
		"a",
		"b",
		"c"
	],
	"a": {
		"b": "c"
	}
}

But with the invention of CoffeeScript you can also write the same thing in CSON which looks like this:

{
	abc: [
		'a'
		'b'
		'c'
	]
	a:
		b: 'c'
}

Which is far more lenient than JSON, nicer to write and read, and won't fail if you forget a comma.

Installing

1. Install Node.js

2. Install CSON

   npm install cson
   

Using CSON

• With Node.js in JavaScript

  // Include CSON
  CSON = require('cson');
  
  // Parse a file path
  CSON.parseFile('data.cson', function(err,obj){});  // async
  result = CSON.parseFileSync('data.cson');  // sync
  result = require('data.cson');  // sync using require
  
  // Parse a String
  CSON.parse(src, function(err,obj){});  // async
  result = CSON.parseSync(src);  // sync
  
  // Stringify an object to CSON
  CSON.stringify(obj, function(err,str){});  // async
  result = CSON.stringifySync(obj);  // sync
  

• With Node.js in CoffeeScript

  # Include CSON
  CSON = require('cson')
  
  # Parse a file path
  CSON.parseFile 'data.cson', (err,obj) ->  # async
  result = CSON.parseFile('data.cson')  # sync
  result = require('data.cson')  # sync using require
  
  # Parse a string
  CSON.parse src, (err,obj) ->  # async
  result = CSON.parseSync(src)  # sync
  
  # Stringify an object to CSON
  CSON.stringify data, (err,str) ->  # async
  result = CSON.stringifySync(obj)  # sync
  
  
  

• Via the command line (requires a global installation of CSON via npm install -g cson)

  # JSON file to CSON String
  json2cson filePath > out.cson
  
  # CSON file to JSON String
  cson2json filePath > out.json
  

History

You can discover the version history inside the History.md file

License

Licensed under the incredibly permissive MIT License
Copyright © 2012 Bevry Pty Ltd
Copyright © 2011 Benjamin Lupton

Thanks

Sincerely, thank you. Lots of love from the CSON Team

Changelog

v1.4.0 2012 October 25

• Dropped require extensions following CoffeeScript's lead - If you still want them, add them to your application manually
• Updated dependencies - coffee-script 1.3.x to 1.4.x