# finite-csv

> A CSV parser that uses a finite state machine and works with Excel CSV exports.

Latest version **0.0.4** (published 2013-07-30) · BSD license · 0 weekly downloads

## Install

```sh
npm install finite-csv
pnpm add finite-csv
yarn add finite-csv
bun add finite-csv
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.4 |
| Published | 2013-07-30 |
| First published | 2013-07-26 |
| Weekly downloads | 0 |
| License | BSD |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | Michael Connor |
| Maintainers | mcheavyd |
| Keywords | finite, state, machine, parse, csv, excel |

## Links

- npm: https://www.npmjs.com/package/finite-csv
- Repository: https://github.com/mlconnor/finite-csv
- npm.io page: https://npm.io/package/finite-csv

## Alternatives

- [csv-to-markdown-table](https://npm.io/package/csv-to-markdown-table.md) — 47.0K weekly downloads
- [@sapphire/ratelimits](https://npm.io/package/@sapphire/ratelimits.md) — 4.4K weekly downloads
- [js-csvparser](https://npm.io/package/js-csvparser.md) — 2.0K weekly downloads
- [@adadapted/js-sdk](https://npm.io/package/@adadapted/js-sdk.md) — 251 weekly downloads
- [@grapecity/spread-sheets-sparklines](https://npm.io/package/@grapecity/spread-sheets-sparklines.md) — 103 weekly downloads

## Recent versions

- 0.0.4 (latest) — 2013-07-30
- 0.0.3 — 2013-07-26
- 0.0.2 — 2013-07-26

## README

finite-csv
==========

A CSV parser that uses a finite state machine and works with Excel CSV exports.

The world doesn't need a new CSV parser but I wanted to play with a light weight finite state machine in JavaScript and I conincidentally couldn't find a parser that would properly parse CSV files output from Excel.

Most CSV parsers split on CR-LF but the spec clearly states that you can have carriage returns in the field if it's enclosed with double quotes.  If you have a cell in Excel that includes a carriage return then it seems that most CSV parsers fail.

The other issue I've found with most parsers is that they require you to either enclose all or none of the fields in quotes.  Excel and other programs will output fields that use quotes only when the contents contain commas or carriage returns.

Finite state machine are probably better used for workflows but I wanted to demonstrate how easy this would be to build using a state machine.  Debugging was simple and it was easy to find errors.

---
_Source: https://npm.io/package/finite-csv · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
