dumb-csv
An unfancy CSV to JSON/markdown parsing lib with no streams or asynchrony
Install
npm install dumb-csv
Usage
const dumbcsv = require('dumb-csv')
dumbcsv
.fromCSV({ data: 'hello,world', separator: ',', headerFields: ['a', 'b'] })
.toJSON()
// [{"a":"hello","b":"world"}]
API
fromCSV(options: { data, file, separator = ',', headerFields, overrideExistingHeader, parseFloats = true }) : { toJSON: () => object, toMarkdown: () => string }
Input options
object:
-
data
(string) -- a string representing the CSV data - OR
file
(string) -- a path to the CSV -
headerFields
(optional string[]) -- an array of strings containing the headers for the CSV, assuming they are not the 1st line -
overrideExistingHeader
(optional bool) -- if the 1st line IS a header, but yourheaderFields
should override it -
parseFloats
(default true) -- if we should try and convert rows that are numbers into JS Number's, or if false keep everything as strings
Output object :
-
toJSON()
(function) -- calling this will return a javascript object that represents the CSV -
toMarkdown()
(function) -- calling this will return a string that has a formatted markdown table inside that represents the CSV