package.json 22.7 KB
Newer Older
Muddsair Sharif's avatar
Muddsair Sharif committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
{
  "_args": [
    [
      {
        "raw": "d3-dsv@1.0.5",
        "scope": null,
        "escapedName": "d3-dsv",
        "name": "d3-dsv",
        "rawSpec": "1.0.5",
        "spec": "1.0.5",
        "type": "version"
      },
      "C:\\Users\\Giuliano\\worldwind\\nasaworldwind\\node\\node_modules\\d3"
    ]
  ],
  "_from": "d3-dsv@1.0.5",
  "_id": "d3-dsv@1.0.5",
  "_inCache": true,
  "_location": "/d3-dsv",
  "_nodeVersion": "7.3.0",
  "_npmOperationalInternal": {
    "host": "packages-18-east.internal.npmjs.com",
    "tmp": "tmp/d3-dsv-1.0.5.tgz_1489169309318_0.5105535357724875"
  },
  "_npmUser": {
    "name": "mbostock",
    "email": "mike@ocks.org"
  },
  "_npmVersion": "3.10.10",
  "_phantomChildren": {},
  "_requested": {
    "raw": "d3-dsv@1.0.5",
    "scope": null,
    "escapedName": "d3-dsv",
    "name": "d3-dsv",
    "rawSpec": "1.0.5",
    "spec": "1.0.5",
    "type": "version"
  },
  "_requiredBy": [
    "/d3",
    "/d3-request"
  ],
  "_resolved": "https://registry.npmjs.org/d3-dsv/-/d3-dsv-1.0.5.tgz",
  "_shasum": "419f7db47f628789fc3fdb636e678449d0821136",
  "_shrinkwrap": null,
  "_spec": "d3-dsv@1.0.5",
  "_where": "C:\\Users\\Giuliano\\worldwind\\nasaworldwind\\node\\node_modules\\d3",
  "author": {
    "name": "Mike Bostock",
    "url": "http://bost.ocks.org/mike"
  },
  "bin": {
    "csv2json": "bin/dsv2json",
    "csv2tsv": "bin/dsv2dsv",
    "dsv2dsv": "bin/dsv2dsv",
    "dsv2json": "bin/dsv2json",
    "json2csv": "bin/json2dsv",
    "json2dsv": "bin/json2dsv",
    "json2tsv": "bin/json2dsv",
    "tsv2csv": "bin/dsv2dsv",
    "tsv2json": "bin/dsv2json"
  },
  "bugs": {
    "url": "https://github.com/d3/d3-dsv/issues"
  },
  "dependencies": {
    "commander": "2",
    "iconv-lite": "0.4",
    "rw": "1"
  },
  "description": "A parser and formatter for delimiter-separated values, such as CSV and TSV",
  "devDependencies": {
    "csv-spectrum": "1",
    "eslint": "3",
    "package-preamble": "0.0",
    "rollup": "0.41",
    "tape": "4",
    "uglify-js": "^2.8.11"
  },
  "directories": {},
  "dist": {
    "shasum": "419f7db47f628789fc3fdb636e678449d0821136",
    "tarball": "https://registry.npmjs.org/d3-dsv/-/d3-dsv-1.0.5.tgz"
  },
  "gitHead": "fbc48ff7e5aba6322d5259dd19a2cf74e4ee3c83",
  "homepage": "https://d3js.org/d3-dsv/",
  "jsnext:main": "index.js",
  "keywords": [
    "d3",
    "d3-module",
    "dsv",
    "csv",
    "tsv"
  ],
  "license": "BSD-3-Clause",
  "main": "build/d3-dsv.js",
  "maintainers": [
    {
      "name": "mbostock",
      "email": "mike@ocks.org"
    }
  ],
  "module": "index",
  "name": "d3-dsv",
  "optionalDependencies": {},
  "readme": "# d3-dsv\n\nThis module provides a parser and formatter for delimiter-separated values, most commonly [comma-](https://en.wikipedia.org/wiki/Comma-separated_values) (CSV) or tab-separated values (TSV). These tabular formats are popular with spreadsheet programs such as Microsoft Excel, and are often more space-efficient than JSON. This implementation is based on [RFC 4180](http://tools.ietf.org/html/rfc4180).\n\nComma (CSV) and tab (TSV) delimiters are built-in. For example, to parse:\n\n```js\nd3.csvParse(\"foo,bar\\n1,2\"); // [{foo: \"1\", bar: \"2\"}, columns: [\"foo\", \"bar\"]]\nd3.tsvParse(\"foo\\tbar\\n1\\t2\"); // [{foo: \"1\", bar: \"2\"}, columns: [\"foo\", \"bar\"]]\n```\n\nOr to format:\n\n```js\nd3.csvFormat([{foo: \"1\", bar: \"2\"}]); // \"foo,bar\\n1,2\"\nd3.tsvFormat([{foo: \"1\", bar: \"2\"}]); // \"foo\\tbar\\n1\\t2\"\n```\n\nTo use a different delimiter, such as “|” for pipe-separated values, use [d3.dsvFormat](#dsvFormat):\n\n```js\nvar psv = d3.dsvFormat(\"|\");\n\nconsole.log(psv.parse(\"foo|bar\\n1|2\")); // [{foo: \"1\", bar: \"2\"}, columns: [\"foo\", \"bar\"]]\n```\n\nFor easy loading of DSV files in a browser, see [d3-request](https://github.com/d3/d3-request)’s [d3.csv](https://github.com/d3/d3-request#csv) and [d3.tsv](https://github.com/d3/d3-request#tsv) methods.\n\n## Installing\n\nIf you use NPM, `npm install d3-dsv`. Otherwise, download the [latest release](https://github.com/d3/d3-dsv/releases/latest). You can also load directly from [d3js.org](https://d3js.org), either as a [standalone library](https://d3js.org/d3-dsv.v1.min.js) or as part of [D3 4.0](https://github.com/d3/d3). AMD, CommonJS, and vanilla environments are supported. In vanilla, a `d3` global is exported:\n\n```html\n<script src=\"https://d3js.org/d3-dsv.v1.min.js\"></script>\n<script>\n\nvar data = d3.csvParse(string);\n\n</script>\n```\n\n[Try d3-dsv in your browser.](https://tonicdev.com/npm/d3-dsv)\n\n## API Reference\n\n<a name=\"csvParse\" href=\"#csvParse\">#</a> d3.<b>csvParse</b>(<i>string</i>[, <i>row</i>]) [<>](https://github.com/d3/d3-dsv/blob/master/src/csv.js#L5 \"Source\")\n\nEquivalent to [dsvFormat](#dsvFormat)(\",\").[parse](#dsv_parse).\n\n<a name=\"csvParseRows\" href=\"#csvParseRows\">#</a> d3.<b>csvParseRows</b>(<i>string</i>[, <i>row</i>]) [<>](https://github.com/d3/d3-dsv/blob/master/src/csv.js#L6 \"Source\")\n\nEquivalent to [dsvFormat](#dsvFormat)(\",\").[parseRows](#dsv_parseRows).\n\n<a name=\"csvFormat\" href=\"#csvFormat\">#</a> d3.<b>csvFormat</b>(<i>rows</i>[, <i>columns</i>]) [<>](https://github.com/d3/d3-dsv/blob/master/src/csv.js#L7 \"Source\")\n\nEquivalent to [dsvFormat](#dsvFormat)(\",\").[format](#dsv_format).\n\n<a name=\"csvFormatRows\" href=\"#csvFormatRows\">#</a> d3.<b>csvFormatRows</b>(<i>rows</i>) [<>](https://github.com/d3/d3-dsv/blob/master/src/csv.js#L8 \"Source\")\n\nEquivalent to [dsvFormat](#dsvFormat)(\",\").[formatRows](#dsv_formatRows).\n\n<a name=\"tsvParse\" href=\"#tsvParse\">#</a> d3.<b>tsvParse</b>(<i>string</i>[, <i>row</i>]) [<>](https://github.com/d3/d3-dsv/blob/master/src/tsv.js#L5 \"Source\")\n\nEquivalent to [dsvFormat](#dsvFormat)(\"\\t\").[parse](#dsv_parse).\n\n<a name=\"tsvParseRows\" href=\"#tsvParseRows\">#</a> d3.<b>tsvParseRows</b>(<i>string</i>[, <i>row</i>]) [<>](https://github.com/d3/d3-dsv/blob/master/src/tsv.js#L6 \"Source\")\n\nEquivalent to [dsvFormat](#dsvFormat)(\"\\t\").[parseRows](#dsv_parseRows).\n\n<a name=\"tsvFormat\" href=\"#tsvFormat\">#</a> d3.<b>tsvFormat</b>(<i>rows</i>[, <i>columns</i>]) [<>](https://github.com/d3/d3-dsv/blob/master/src/tsv.js#L7 \"Source\")\n\nEquivalent to [dsvFormat](#dsvFormat)(\"\\t\").[format](#dsv_format).\n\n<a name=\"tsvFormatRows\" href=\"#tsvFormatRows\">#</a> d3.<b>tsvFormatRows</b>(<i>rows</i>) [<>](https://github.com/d3/d3-dsv/blob/master/src/tsv.js#L8 \"Source\")\n\nEquivalent to [dsvFormat](#dsvFormat)(\"\\t\").[formatRows](#dsv_formatRows).\n\n<a name=\"dsvFormat\" href=\"#dsvFormat\">#</a> d3.<b>dsvFormat</b>(<i>delimiter</i>) [<>](https://github.com/d3/d3-dsv/blob/master/src/dsv.js#L30)\n\nConstructs a new DSV parser and formatter for the specified *delimiter*. The *delimiter* must be a single character (*i.e.*, a single 16-bit code unit); so, ASCII delimiters are fine, but emoji delimiters are not.\n\n<a name=\"dsv_parse\" href=\"#dsv_parse\">#</a> *dsv*.<b>parse</b>(<i>string</i>[, <i>row</i>]) [<>](https://github.com/d3/d3-dsv/blob/master/src/dsv.js#L34 \"Source\")\n\nParses the specified *string*, which must be in the delimiter-separated values format with the appropriate delimiter, returning an array of objects representing the parsed rows.\n\nUnlike [*dsv*.parseRows](#dsv_parseRows), this method requires that the first line of the DSV content contains a delimiter-separated list of column names; these column names become the attributes on the returned objects. For example, consider the following CSV file:\n\n```\nYear,Make,Model,Length\n1997,Ford,E350,2.34\n2000,Mercury,Cougar,2.38\n```\n\nThe resulting JavaScript array is:\n\n```js\n[\n  {\"Year\": \"1997\", \"Make\": \"Ford\", \"Model\": \"E350\", \"Length\": \"2.34\"},\n  {\"Year\": \"2000\", \"Make\": \"Mercury\", \"Model\": \"Cougar\", \"Length\": \"2.38\"}\n]\n```\n\nThe returned array also exposes a `columns` property containing the column names in input order (in contrast to Object.keys, whose iteration order is arbitrary). For example:\n\n```js\ndata.columns; // [\"Year\", \"Make\", \"Model\", \"Length\"]\n```\n\nIf a *row* conversion function is not specified, field values are strings. For safety, there is no automatic conversion to numbers, dates, or other types. In some cases, JavaScript may coerce strings to numbers for you automatically (for example, using the `+` operator), but better is to specify a *row* conversion function.\n\nIf a *row* conversion function is specified, the specified function is invoked for each row, being passed an object representing the current row (`d`), the index (`i`) starting at zero for the first non-header row, and the array of column names. If the returned value is null or undefined, the row is skipped and will be ommitted from the array returned by *dsv*.parse; otherwise, the returned value defines the corresponding row object. For example:\n\n```js\nvar data = d3.csvParse(string, function(d) {\n  return {\n    year: new Date(+d.Year, 0, 1), // lowercase and convert \"Year\" to Date\n    make: d.Make, // lowercase\n    model: d.Model, // lowercase\n    length: +d.Length // lowercase and convert \"Length\" to number\n  };\n});\n```\n\nNote: using `+` rather than [parseInt](https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/parseInt) or [parseFloat](https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/parseFloat) is typically faster, though more restrictive. For example, `\"30px\"` when coerced using `+` returns `NaN`, while parseInt and parseFloat return `30`.\n\n<a name=\"dsv_parseRows\" href=\"#dsv_parseRows\">#</a> <i>dsv</i>.<b>parseRows</b>(<i>string</i>[, <i>row</i>]) [<>](https://github.com/d3/d3-dsv/blob/master/src/dsv.js#L43 \"Source\")\n\nParses the specified *string*, which must be in the delimiter-separated values format with the appropriate delimiter, returning an array of arrays representing the parsed rows.\n\nUnlike [*dsv*.parse](#dsv_parse), this method treats the header line as a standard row, and should be used whenever DSV content does not contain a header. Each row is represented as an array rather than an object. Rows may have variable length. For example, consider the following CSV file, which notably lacks a header line:\n\n```\n1997,Ford,E350,2.34\n2000,Mercury,Cougar,2.38\n```\n\nThe resulting JavaScript array is:\n\n```js\n[\n  [\"1997\", \"Ford\", \"E350\", \"2.34\"],\n  [\"2000\", \"Mercury\", \"Cougar\", \"2.38\"]\n]\n```\n\nIf a *row* conversion function is not specified, field values are strings. For safety, there is no automatic conversion to numbers, dates, or other types. In some cases, JavaScript may coerce strings to numbers for you automatically (for example, using the `+` operator), but better is to specify a *row* conversion function.\n\nIf a *row* conversion function is specified, the specified function is invoked for each row, being passed an array representing the current row (`d`), the index (`i`) starting at zero for the first row, and the array of column names. If the returned value is null or undefined, the row is skipped and will be ommitted from the array returned by *dsv*.parse; otherwise, the returned value defines the corresponding row object. For example:\n\n```js\nvar data = d3.csvParseRows(string, function(d, i) {\n  return {\n    year: new Date(+d[0], 0, 1), // convert first colum column to Date\n    make: d[1],\n    model: d[2],\n    length: +d[3] // convert fourth column to number\n  };\n});\n```\n\nIn effect, *row* is similar to applying a [map](https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Array/map) and [filter](https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Array/filter) operator to the returned rows.\n\n<a name=\"dsv_format\" href=\"#dsv_format\">#</a> <i>dsv</i>.<b>format</b>(<i>rows</i>[, <i>columns</i>]) [<>](https://github.com/d3/d3-dsv/blob/master/src/dsv.js#L105 \"Source\")\n\nFormats the specified array of object *rows* as delimiter-separated values, returning a string. This operation is the inverse of [*dsv*.parse](#dsv_parse). Each row will be separated by a newline (`\\n`), and each column within each row will be separated by the delimiter (such as a comma, `,`). Values that contain either the delimiter, a double-quote (`\"`) or a newline will be escaped using double-quotes.\n\nIf *columns* is not specified, the list of column names that forms the header row is determined by the union of all properties on all objects in *rows*; the order of columns is nondeterministic. If *columns* is specified, it is an array of strings representing the column names. For example:\n\n```js\nvar string = d3.csvFormat(data, [\"year\", \"make\", \"model\", \"length\"]);\n```\n\nAll fields on each row object will be coerced to strings. For more control over which and how fields are formatted, first map *rows* to an array of array of string, and then use [*dsv*.formatRows](#dsv_formatRows).\n\n<a name=\"dsv_formatRows\" href=\"#dsv_formatRows\">#</a> <i>dsv</i>.<b>formatRows</b>(<i>rows</i>) [<>](https://github.com/d3/d3-dsv/blob/master/src/dsv.js#L114 \"Source\")\n\nFormats the specified array of array of string *rows* as delimiter-separated values, returning a string. This operation is the reverse of [*dsv*.parseRows](#dsv_parseRows). Each row will be separated by a newline (`\\n`), and each column within each row will be separated by the delimiter (such as a comma, `,`). Values that contain either the delimiter, a double-quote (\") or a newline will be escaped using double-quotes.\n\nTo convert an array of objects to an array of arrays while explicitly specifying the columns, use [*array*.map](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map). For example:\n\n```js\nvar string = d3.csvFormatRows(data.map(function(d, i) {\n  return [\n    d.year.getFullYear(), // Assuming d.year is a Date object.\n    d.make,\n    d.model,\n    d.length\n  ];\n}));\n```\n\nIf you like, you can also [*array*.concat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/concat) this result with an array of column names to generate the first row:\n\n```js\nvar string = d3.csvFormatRows([[\n    \"year\",\n    \"make\",\n    \"model\",\n    \"length\"\n  ]].concat(data.map(function(d, i) {\n  return [\n    d.year.getFullYear(), // Assuming d.year is a Date object.\n    d.make,\n    d.model,\n    d.length\n  ];\n})));\n```\n\n### Content Security Policy\n\nIf a [content security policy](http://www.w3.org/TR/CSP/) is in place, note that [*dsv*.parse](#dsv_parse) requires `unsafe-eval` in the `script-src` directive, due to the (safe) use of dynamic code generation for fast parsing. (See [source](https://github.com/d3/d3-dsv/blob/master/src/dsv.js).) Alternatively, use [*dsv*.parseRows](#dsv_parseRows).\n\n## Command Line Reference\n\n### dsv2dsv\n\n<a name=\"dsv2dsv\" href=\"#dsv2dsv\">#</a> <b>dsv2dsv</b> [<i>options…</i>] [<i>file</i>]\n\nConverts the specified DSV input *file* to DSV (typically with a different delimiter or encoding). If *file* is not specified, defaults to reading from stdin. For example, to convert to CSV to TSV:\n\n```\ncsv2tsv < example.csv > example.tsv\n```\n\nTo convert windows-1252 CSV to utf-8 CSV:\n\n```\ndsv2dsv --input-encoding windows-1252 < latin1.csv > utf8.csv\n```\n\n<a name=\"dsv2dsv_help\" href=\"dsv2dsv_help\">#</a> dsv2dsv <b>-h</b>\n<br><a href=\"dsv2dsv_help\">#</a> dsv2dsv <b>--help</b>\n\nOutput usage information.\n\n<a name=\"dsv2dsv_version\" href=\"dsv2dsv_version\">#</a> dsv2dsv <b>-V</b>\n<br><a href=\"dsv2dsv_version\">#</a> dsv2dsv <b>--version</b>\n\nOutput the version number.\n\n<a name=\"dsv2dsv_out\" href=\"dsv2dsv_out\">#</a> dsv2dsv <b>-o</b> <i>file</i>\n<br><a href=\"dsv2dsv_out\">#</a> dsv2dsv <b>--out</b> <i>file</i>\n\nSpecify the output file name. Defaults to “-” for stdout.\n\n<a name=\"dsv2dsv_input_delimiter\" href=\"dsv2dsv_input_delimiter\">#</a> dsv2dsv <b>-r</b> <i>delimiter</i>\n<br><a href=\"dsv2dsv_input_delimiter\">#</a> dsv2dsv <b>--input-delimiter</b> <i>delimiter</i>\n\nSpecify the input delimiter character. Defaults to “,” for reading CSV. (You can enter a tab on the command line by typing ⌃V.)\n\n<a name=\"dsv2dsv_input_encoding\" href=\"dsv2dsv_input_encoding\">#</a> dsv2dsv <b>--input-encoding</b> <i>encoding</i>\n\nSpecify the input character encoding. Defaults to “utf8”.\n\n<a name=\"dsv2dsv_output_delimiter\" href=\"dsv2dsv_output_delimiter\">#</a> dsv2dsv <b>-w</b> <i>delimiter</i>\n<br><a href=\"dsv2dsv_output_delimiter\">#</a> dsv2dsv <b>--output-delimiter</b> <i>delimiter</i>\n\nSpecify the output delimiter character. Defaults to “,” for writing CSV. (You can enter a tab on the command line by typing ⌃V.)\n\n<a name=\"dsv2dsv_output_encoding\" href=\"dsv2dsv_output_encoding\">#</a> dsv2dsv <b>--output-encoding</b> <i>encoding</i>\n\nSpecify the output character encoding. Defaults to “utf8”.\n\n<a name=\"csv2tsv\" href=\"#csv2tsv\">#</a> <b>csv2tsv</b> [<i>options…</i>] [<i>file</i>]\n\nEquivalent to [dsv2dsv](#dsv2dsv), but the [output delimiter](#dsv2dsv_output_delimiter) defaults to the tab character (\\t).\n\n<a name=\"tsv2csv\" href=\"#tsv2csv\">#</a> <b>tsv2csv</b> [<i>options…</i>] [<i>file</i>]\n\nEquivalent to [dsv2dsv](#dsv2dsv), but the [input delimiter](#dsv2dsv_output_delimiter) defaults to the tab character (\\t).\n\n### dsv2json\n\n<a name=\"dsv2json\" href=\"#dsv2json\">#</a> <b>dsv2json</b> [<i>options…</i>] [<i>file</i>]\n\nConverts the specified DSV input *file* to JSON. If *file* is not specified, defaults to reading from stdin. For example, to convert to CSV to JSON:\n\n```\ncsv2json < example.csv > example.json\n```\n\nOr to convert CSV to a newline-delimited JSON stream:\n\n```\ncsv2json -n < example.csv > example.ndjson\n```\n\n<a name=\"dsv2json_help\" href=\"dsv2json_help\">#</a> dsv2json <b>-h</b>\n<br><a href=\"dsv2json_help\">#</a> dsv2json <b>--help</b>\n\nOutput usage information.\n\n<a name=\"dsv2json_version\" href=\"dsv2json_version\">#</a> dsv2json <b>-V</b>\n<br><a href=\"dsv2json_version\">#</a> dsv2json <b>--version</b>\n\nOutput the version number.\n\n<a name=\"dsv2json_out\" href=\"dsv2json_out\">#</a> dsv2json <b>-o</b> <i>file</i>\n<br><a href=\"dsv2json_out\">#</a> dsv2json <b>--out</b> <i>file</i>\n\nSpecify the output file name. Defaults to “-” for stdout.\n\n<a name=\"dsv2json_input_delimiter\" href=\"dsv2json_input_delimiter\">#</a> dsv2json <b>-r</b> <i>delimiter</i>\n<br><a href=\"dsv2json_input_delimiter\">#</a> dsv2json <b>--input-delimiter</b> <i>delimiter</i>\n\nSpecify the input delimiter character. Defaults to “,” for reading CSV. (You can enter a tab on the command line by typing ⌃V.)\n\n<a name=\"dsv2json_input_encoding\" href=\"dsv2json_input_encoding\">#</a> dsv2json <b>--input-encoding</b> <i>encoding</i>\n\nSpecify the input character encoding. Defaults to “utf8”.\n\n<a name=\"dsv2json_output_encoding\" href=\"dsv2json_output_encoding\">#</a> dsv2json <b>-r</b> <i>encoding</i>\n<br><a href=\"dsv2json_output_encoding\">#</a> dsv2json <b>--output-encoding</b> <i>encoding</i>\n\nSpecify the output character encoding. Defaults to “utf8”.\n\n<a name=\"dsv2json_newline_delimited\" href=\"dsv2json_newline_delimited\">#</a> dsv2json <b>-n</b>\n<br><a href=\"dsv2json_newline_delimited\">#</a> dsv2json <b>--newline-delimited</b>\n\nOutput [newline-delimited JSON](https://github.com/mbostock/ndjson-cli) instead of a single JSON array.\n\n<a name=\"csv2json\" href=\"#csv2json\">#</a> <b>csv2json</b> [<i>options…</i>] [<i>file</i>]\n\nEquivalent to [dsv2json](#dsv2json).\n\n<a name=\"tsv2json\" href=\"#csv2json\">#</a> <b>tsv2json</b> [<i>options…</i>] [<i>file</i>]\n\nEquivalent to [dsv2json](#dsv2json), but the [input delimiter](#dsv2json_input_delimiter) defaults to the tab character (\\t).\n\n### json2dsv\n\n<a name=\"json2dsv\" href=\"#json2dsv\">#</a> <b>json2dsv</b> [<i>options…</i>] [<i>file</i>]\n\nConverts the specified JSON input *file* to DSV. If *file* is not specified, defaults to reading from stdin. For example, to convert to JSON to CSV:\n\n```\njson2csv < example.json > example.csv\n```\n\nOr to convert a newline-delimited JSON stream to CSV:\n\n```\njson2csv -n < example.ndjson > example.csv\n```\n\n<a name=\"json2dsv_help\" href=\"json2dsv_help\">#</a> json2dsv <b>-h</b>\n<br><a href=\"json2dsv_help\">#</a> json2dsv <b>--help</b>\n\nOutput usage information.\n\n<a name=\"json2dsv_version\" href=\"json2dsv_version\">#</a> json2dsv <b>-V</b>\n<br><a href=\"json2dsv_version\">#</a> json2dsv <b>--version</b>\n\nOutput the version number.\n\n<a name=\"json2dsv_out\" href=\"json2dsv_out\">#</a> json2dsv <b>-o</b> <i>file</i>\n<br><a href=\"json2dsv_out\">#</a> json2dsv <b>--out</b> <i>file</i>\n\nSpecify the output file name. Defaults to “-” for stdout.\n\n<a name=\"json2dsv_input_encoding\" href=\"json2dsv_input_encoding\">#</a> json2dsv <b>--input-encoding</b> <i>encoding</i>\n\nSpecify the input character encoding. Defaults to “utf8”.\n\n<a name=\"json2dsv_output_delimiter\" href=\"json2dsv_output_delimiter\">#</a> json2dsv <b>-w</b> <i>delimiter</i>\n<br><a href=\"json2dsv_output_delimiter\">#</a> json2dsv <b>--output-delimiter</b> <i>delimiter</i>\n\nSpecify the output delimiter character. Defaults to “,” for writing CSV. (You can enter a tab on the command line by typing ⌃V.)\n\n<a name=\"json2dsv_output_encoding\" href=\"json2dsv_output_encoding\">#</a> json2dsv <b>--output-encoding</b> <i>encoding</i>\n\nSpecify the output character encoding. Defaults to “utf8”.\n\n<a name=\"json2dsv_newline_delimited\" href=\"json2dsv_newline_delimited\">#</a> json2dsv <b>-n</b>\n<br><a href=\"json2dsv_newline_delimited\">#</a> json2dsv <b>--newline-delimited</b>\n\nRead [newline-delimited JSON](https://github.com/mbostock/ndjson-cli) instead of a single JSON array.\n\n<a name=\"csv2json\" href=\"#csv2json\">#</a> <b>csv2json</b> [<i>options…</i>] [<i>file</i>]\n\nEquivalent to [json2dsv](#json2dsv).\n\n<a name=\"tsv2json\" href=\"#csv2json\">#</a> <b>tsv2json</b> [<i>options…</i>] [<i>file</i>]\n\nEquivalent to [json2dsv](#json2dsv), but the [output delimiter](#json2dsv_output_delimiter) defaults to the tab character (\\t).\n",
  "readmeFilename": "README.md",
  "repository": {
    "type": "git",
    "url": "git+https://github.com/d3/d3-dsv.git"
  },
  "scripts": {
    "postpublish": "git push && git push --tags && cd ../d3.github.com && git pull && cp ../d3-dsv/build/d3-dsv.js d3-dsv.v1.js && cp ../d3-dsv/build/d3-dsv.min.js d3-dsv.v1.min.js && git add d3-dsv.v1.js d3-dsv.v1.min.js && git commit -m \"d3-dsv ${npm_package_version}\" && git push && cd - && zip -j build/d3-dsv.zip -- LICENSE README.md build/d3-dsv.js build/d3-dsv.min.js",
    "prepublish": "npm run test && uglifyjs --preamble \"$(preamble)\" build/d3-dsv.js -c -m -o build/d3-dsv.min.js",
    "pretest": "rm -rf build && mkdir build && rollup --banner \"$(preamble)\" -f umd -n d3 -o build/d3-dsv.js -- index.js",
    "test": "tape 'test/**/*-test.js' && eslint index.js src"
  },
  "version": "1.0.5"
}