[](http://travis-ci.org/wdavidw/node-csv-parser)
_ _ _ _____ _______ __
| \ | | | | / ____|/ ____\ \ / /
| \| | ___ __| | ___ | | | (___ \ \ / /
| . ` |/ _ \ / _` |/ _ \| | \___ \ \ \/ /
| |\ | (_) | (_| | __/| |____ ____) | \ /
|_| \_|\___/ \__,_|\___| \_____|_____/ \/ New BSD License
This project provides CSV parsing and has been tested and used
on large input files. It provide every option you could expect from an
advanced CSV parser and stringifier.
[Documentation for the CSV parser is available here](http://www.adaltas.com/projects/node-csv/).
Usage
-----
Installation command is `npm install csv`.
### Quick example
```javascript
// node samples/string.js
var csv = require('csv');
csv()
.from( '"1","2","3","4"\n"a","b","c","d"' )
.to( console.log )
// Output:
// 1,2,3,4
// a,b,c,d
```
### Advanced example
```javascript
// node samples/sample.js
var fs = require('fs');
var csv = require('csv');
csv()
.from.stream(fs.createReadStream(__dirname+'/sample.in'))
.to.path(__dirname+'/sample.out')
.transform( function(row){
row.unshift(row.pop());
return row;
})
.on('record', function(row,index){
console.log('#'+index+' '+JSON.stringify(row));
})
.on('end', function(count){
console.log('Number of lines: '+count);
})
.on('error', function(error){
console.log(error.message);
});
// Output:
// #0 ["2000-01-01","20322051544","1979.0","8.8017226E7","ABC","45"]
// #1 ["2050-11-27","28392898392","1974.0","8.8392926E7","DEF","23"]
// Number of lines: 2
```
Migration
---------
This readme cover the current version 0.2.x of the node
csv parser. The documentation for the current version 0.1.0 is
available [here](https://github.com/wdavidw/node-csv-parser/tree/v0.1).
The functions 'from*' and 'to*' are now rewritten as 'from.*' and 'to.*'. The 'data'
event is now the 'record' event. The 'data' now receives a stringified version of
the 'record' event.
Development
-----------
Tests are executed with mocha. To install it, simple run `npm install`, it will install
mocha and its dependencies in your project "node_modules" directory.
To run the tests:
```bash
npm test
```
The tests run against the CoffeeScript source files.
To generate the JavaScript files:
```bash
make build
```
The test suite is run online with [Travis][travis] against Node.js version 0.6, 0.7, 0.8 and 0.9.
Contributors
------------
* David Worms:
* Will White:
* Justin Latimer:
* jonseymour:
* pascalopitz:
* Josh Pschorr:
* Elad Ben-Israel:
* Philippe Plantier:
* Tim Oxley:
* Damon Oehlman:
* Alexandru Topliceanu:
* Visup:
* Edmund von der Burg:
* Douglas Christopher Wilson:
* Chris Khoo:
Related projects
----------------
* Pavel Kolesnikov "ya-csv":
* Chris Williams "node-csv":
[travis]: https://travis-ci.org/#!/wdavidw/node-csv-parser