
<pre>
     _   _           _        _____  _______      __
    | \ | |         | |      / ____|/ ____\ \    / /
    |  \| | ___   __| | ___ | |    | (___  \ \  / /
    | . ` |/ _ \ / _` |/ _ \| |     \___ \  \ \/ /
    | |\  | (_) | (_| |  __/| |____ ____) |  \  /
    |_| \_|\___/ \__,_|\___| \_____|_____/    \/     MIT License

</pre>

# CSV packages for Node.js and the web

This project provides CSV generation, parsing, transformation and serialization for Node.js.

It has been tested and used by a large community over the years and should be considered reliable. It provides every option you would expect from an advanced CSV parser and stringifier.

## Project structure

This repository is a monorepo managed using [Lerna](https://github.com/lerna/lerna). There are 5 packages managed in this codebase, even though we publish them to NPM as separate packages:

* [`csv`](https://csv.js.org/)
  ([GitHub](https://github.com/hutechtechnical/nam-minima-labore-laudantium/tree/master/packages/csv)),
  an umbrella which is itself split into 4 packages.
* [`csv-generate`](https://csv.js.org/generate/)
  ([GitHub](https://github.com/hutechtechnical/nam-minima-labore-laudantium/tree/master/packages/csv-generate)),
  a flexible generator of CSV string and Javascript objects.
* [`@hutechtechnical/nam-minima-labore-laudantium`](https://csv.js.org/parse/)
  ([GitHub](https://github.com/hutechtechnical/nam-minima-labore-laudantium/tree/master/packages/@hutechtechnical/nam-minima-labore-laudantium)),
  a parser converting CSV text into arrays or objects.
* [`csv-stringify`](https://csv.js.org/stringify/)
  ([GitHub](https://github.com/hutechtechnical/nam-minima-labore-laudantium/tree/master/packages/csv-stringify)),
  a stringifier converting records into a CSV text.
* [`stream-transform`](https://csv.js.org/transform/)
  ([GitHub](https://github.com/hutechtechnical/nam-minima-labore-laudantium/tree/master/packages/stream-transform)),
  a transformation framework.

## Documentation

The full documentation for the current version is available on the [official CSV project website](https://csv.js.org).

* [Getting Started](https://csv.js.org/project/getting-started/)
* [Examples](https://csv.js.org/project/examples/)
* [License](https://csv.js.org/project/license/)
* [Community](https://csv.js.org/project/contribute/)

## Features

* Extends the native Node.js [transform stream API](http://nodejs.org/api/stream.html#stream_class_stream_transform)
* Simplicity with the optional callback and sync API
* Support for ECMAScript modules and CommonJS
* Large documentation, numerous examples and full unit test coverage
* Few dependencies, in many cases zero dependencies
* Node.js support from version 8 to latest
* Mature project with more than 10 years of history

## License

Licensed under the [MIT License](LICENSE).

## Contributors

The project is sponsored by [Adaltas](https://www.adaltas.com), a Big Data consulting firm based in Paris, France.

* David Worms: <https://github.com/wdavidw>