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.json
and install all of the dependencies needed to build ucsv. - Run
grunt
to 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.