fs-cson

Read and write CSON to the filesystem, require CSON files

Installation

npm install fs-cson

API

readFile(filePath, callback)

Asynchronously reads the file and parses the contents. The callback is passed two arguments (err, data), where data is the parsed object.

Synchronous version: readFileSync(filePath)

Example

1# sample.cson
2a: 1
3b: 2
4
5# read.coffee
6fsCson = require 'fs-cson'
7
8fsCson.readFile 'sample.cson', (err, data) ->
9  # data will be {a: 1, b: 2}

---

register()

Allows cson files to be required.

1fsCson = require 'fs-cson'
2fsCson.register()
3
4# or
5
6require 'fs-cson/register'

---

updateFile(filePath, updater, callback)

Asynchronously reads the file, parses the contents, calls updater, and writes the stringified object. updater is passed on argument (data) and should return the updated data. The callback is passed one argument (err).

Synchronous version: updateFileSync(filePath, updater)

Example

1# sample.cson
2a: 1
3b: 2
4
5# update.coffee
6fsCson = require 'fs-cson'
7
8updater = (data) ->
9  result = {}
10  for key, value in data
11    result[key] = value * 2
12  result.c = 6
13  result
14
15fsCson.updateFile 'sample.cson', (err) ->
16  # sample.cson now has the content
17  # a: 2
18  # b: 4
19  # c: 6

---

writeFile(filePath, object, callback)

Stringifies the object and then asynchronously writes to a file. The callback is passed one argument (err).

Synchronous version: writeFileSync(filePath, object)

1# write.coffee
2fsCson = require 'fs-cson'
3
4fsCson.writeFile 'sample.cson', {a: 1, b: 2}, (err) ->
5  # sample.cson now has the content
6  # a: 1
7  # b: 2

---

writeFileSafe(filePath, object, callback)

Same as writeFile but creates parent directories if they do not exist.

Synchronous version: writeFileSafeSync(filePath, object)