UCSV is a small library for importing and exporting CSV into and out of ECMAScript programs. CSV text can be imported into a multi-dimensional array or an array of objects if column headings are available. These structures can also easily be output as CSV text.
- MIT, GLP3 dual licensed
- Simple, namespaced API
- Small (less than 1.5kb when minified and gzipped)
- When exporting to CSV appropriate fields are automatically quoted
- Optionally strip leading and trailing whitespace from fields
- Proper support for quotes, commas and line-breaks in quoted fields
- Use in browser or as a CommonJS module.
Grab a copy of ucsv-x.x.x.min.js from the dist/ directory and include it
in your project. If you would like sourcemap support, you will need to build
the library your self with the grunt gz command and then grab ucsv-x.x.x.min.js.map
and the ucsv_x.x.x_src directory as well.
- Install node.js, this will also install npm
- Install grunt
- Clone the Git repository
git clone https://github.com/uselesscode/ucsv.git - In the cloned directory, run
npm install, this will readpackage.jsonand install all of the dependencies needed to build ucsv. - Run
gruntto build ucsv.
grunt will run tests, jshint and then build a minified copy of the
library in dist/ as well as documentation in docs/.
grunt gz will do everything that the default command does but it will
also generated .gz compressed versions of the library and .map file.
grunt test will run the test suite on the source files without building.
grunt docs will just generate documentation.
grunt notest will build a copy of the library without linting or running tests
grunt keepconcat the default build will delete the non-minified version of the
concatenated source, keepconcat will not.
grunt cleanup will remove the dist and docs directories.