{"_id":"parse-columns","_rev":"232615","name":"parse-columns","description":"Parse text columns, like the output of Unix commands","dist-tags":{"latest":"3.0.0"},"maintainers":[{"name":"sindresorhus","email":""}],"time":{"modified":"2023-03-24T16:06:37.000Z","created":"2015-06-16T10:27:19.557Z","3.0.0":"2021-11-04T05:26:03.651Z","2.0.0":"2019-04-23T10:31:05.869Z","1.3.0":"2015-11-14T11:07:16.609Z","1.2.0":"2015-10-15T18:33:42.929Z","1.1.0":"2015-07-07T13:12:46.223Z","1.0.1":"2015-06-30T21:23:44.496Z","1.0.0":"2015-06-16T10:27:19.557Z"},"users":{},"author":{"name":"Sindre Sorhus","email":"sindresorhus@gmail.com","url":"https://sindresorhus.com"},"repository":{"type":"git","url":"git+https://github.com/sindresorhus/parse-columns.git"},"versions":{"3.0.0":{"name":"parse-columns","version":"3.0.0","description":"Parse text columns, like the output of Unix commands","license":"MIT","repository":{"type":"git","url":"git+https://github.com/sindresorhus/parse-columns.git"},"funding":"https://github.com/sponsors/sindresorhus","author":{"name":"Sindre Sorhus","email":"sindresorhus@gmail.com","url":"https://sindresorhus.com"},"type":"module","exports":"./index.js","engines":{"node":"^12.20.0 || ^14.13.1 || >=16.0.0"},"scripts":{"test":"xo && ava && tsd"},"keywords":["parse","parser","columns","column","row","text","string","unix","command","output","csv","shell","sh","term","table"],"dependencies":{"escape-string-regexp":"^5.0.0","execall":"^3.0.0","split-at":"^3.0.0"},"devDependencies":{"ava":"^3.15.0","tsd":"^0.18.0","xo":"^0.46.4"},"types":"./index.d.ts","gitHead":"3169c69ff74a871ec895244e59707d8216dd1d3c","bugs":{"url":"https://github.com/sindresorhus/parse-columns/issues"},"homepage":"https://github.com/sindresorhus/parse-columns#readme","_id":"parse-columns@3.0.0","_nodeVersion":"12.22.1","_npmVersion":"8.1.0","dist":{"shasum":"d26311d7a314aac63a11dbd5803e5d1d7e8151d7","size":3188,"noattachment":false,"key":"/parse-columns/-/parse-columns-3.0.0.tgz","tarball":"http://name.csiicloud.com:7001/parse-columns/download/parse-columns-3.0.0.tgz"},"_npmUser":{"name":"sindresorhus","email":"sindresorhus@gmail.com"},"directories":{},"maintainers":[{"name":"sindresorhus","email":""}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/parse-columns_3.0.0_1636003563511_0.73305062694962"},"_hasShrinkwrap":false,"publish_time":1636003563651,"_cnpm_publish_time":1636003563651,"_cnpmcore_publish_time":"2021-12-16T20:39:25.095Z"},"2.0.0":{"name":"parse-columns","version":"2.0.0","description":"Parse text columns, like the output of Unix commands","license":"MIT","repository":{"type":"git","url":"git+https://github.com/sindresorhus/parse-columns.git"},"author":{"name":"Sindre Sorhus","email":"sindresorhus@gmail.com","url":"sindresorhus.com"},"engines":{"node":">=8"},"scripts":{"test":"xo && ava && tsd"},"keywords":["parse","parser","columns","column","row","text","string","unix","command","output","csv","shell","sh","term","table"],"dependencies":{"escape-string-regexp":"^2.0.0","execall":"^2.0.0","split-at":"^2.0.0"},"devDependencies":{"ava":"^1.4.1","tsd":"^0.7.2","xo":"^0.24.0"},"gitHead":"0c1292219a81f998ff524f33a79b3521035b8758","bugs":{"url":"https://github.com/sindresorhus/parse-columns/issues"},"homepage":"https://github.com/sindresorhus/parse-columns#readme","_id":"parse-columns@2.0.0","_npmVersion":"6.4.1","_nodeVersion":"10.15.3","_npmUser":{"name":"sindresorhus","email":"sindresorhus@gmail.com"},"dist":{"shasum":"e66e9ba093e392f294bc25b9675efaf1f6482b3c","size":3317,"noattachment":false,"key":"/parse-columns/-/parse-columns-2.0.0.tgz","tarball":"http://name.csiicloud.com:7001/parse-columns/download/parse-columns-2.0.0.tgz"},"maintainers":[{"name":"sindresorhus","email":""}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/parse-columns_2.0.0_1556015465716_0.32371622748949713"},"_hasShrinkwrap":false,"publish_time":1556015465869,"_cnpm_publish_time":1556015465869,"_cnpmcore_publish_time":"2021-12-16T20:39:25.336Z"},"1.3.0":{"name":"parse-columns","version":"1.3.0","description":"Parse text columns, like the output of unix commands","license":"MIT","repository":{"type":"git","url":"https://github.com/sindresorhus/parse-columns"},"author":{"name":"Sindre Sorhus","email":"sindresorhus@gmail.com","url":"sindresorhus.com"},"engines":{"node":">=0.10.0"},"scripts":{"test":"ava"},"files":["index.js"],"keywords":["parse","parser","columns","column","col","row","text","string","str","unix","command","cmd","output","csv","shell","sh","term","table"],"dependencies":{"escape-string-regexp":"^1.0.3","execall":"^1.0.0","repeating":"^2.0.0","split-at":"^1.1.0"},"devDependencies":{"ava":"*"},"gitHead":"193ad45743c3fbc0b07fb8436aad04fa019aba3e","bugs":{"url":"https://github.com/sindresorhus/parse-columns/issues"},"homepage":"https://github.com/sindresorhus/parse-columns","_id":"parse-columns@1.3.0","_shasum":"4353f662669910b20646a70871038e482aef04bc","_from":".","_npmVersion":"2.14.7","_nodeVersion":"4.2.1","_npmUser":{"name":"sindresorhus","email":"sindresorhus@gmail.com"},"dist":{"shasum":"4353f662669910b20646a70871038e482aef04bc","size":2990,"noattachment":false,"key":"/parse-columns/-/parse-columns-1.3.0.tgz","tarball":"http://name.csiicloud.com:7001/parse-columns/download/parse-columns-1.3.0.tgz"},"maintainers":[{"name":"sindresorhus","email":""}],"directories":{},"publish_time":1447499236609,"_hasShrinkwrap":false,"_cnpm_publish_time":1447499236609,"_cnpmcore_publish_time":"2021-12-16T20:39:25.611Z"},"1.2.0":{"name":"parse-columns","version":"1.2.0","description":"Parse text columns, like the output of unix commands","license":"MIT","repository":{"type":"git","url":"https://github.com/sindresorhus/parse-columns"},"author":{"name":"Sindre Sorhus","email":"sindresorhus@gmail.com","url":"sindresorhus.com"},"engines":{"node":">=0.10.0"},"scripts":{"test":"node test.js"},"files":["index.js"],"keywords":["parse","parser","columns","column","col","row","text","string","str","unix","command","cmd","output","csv","shell","sh","term","table"],"dependencies":{"escape-string-regexp":"^1.0.3","execall":"^1.0.0","repeating":"^2.0.0","split-at":"^1.1.0"},"devDependencies":{"ava":"^0.2.0"},"gitHead":"38f440d3941c221218f740127599c5eb988e4811","bugs":{"url":"https://github.com/sindresorhus/parse-columns/issues"},"homepage":"https://github.com/sindresorhus/parse-columns","_id":"parse-columns@1.2.0","_shasum":"19f15e057b6dee91261ced5c104b1ae3a18accd4","_from":".","_npmVersion":"2.14.4","_nodeVersion":"4.1.1","_npmUser":{"name":"sindresorhus","email":"sindresorhus@gmail.com"},"dist":{"shasum":"19f15e057b6dee91261ced5c104b1ae3a18accd4","size":2945,"noattachment":false,"key":"/parse-columns/-/parse-columns-1.2.0.tgz","tarball":"http://name.csiicloud.com:7001/parse-columns/download/parse-columns-1.2.0.tgz"},"maintainers":[{"name":"sindresorhus","email":""}],"directories":{},"publish_time":1444934022929,"_hasShrinkwrap":false,"_cnpm_publish_time":1444934022929,"_cnpmcore_publish_time":"2021-12-16T20:39:25.843Z"},"1.1.0":{"name":"parse-columns","version":"1.1.0","description":"Parse text columns, like the output of unix commands","license":"MIT","repository":{"type":"git","url":"https://github.com/sindresorhus/parse-columns"},"author":{"name":"Sindre Sorhus","email":"sindresorhus@gmail.com","url":"sindresorhus.com"},"engines":{"node":">=0.10.0"},"scripts":{"test":"node test.js"},"files":["index.js"],"keywords":["parse","parser","columns","column","col","row","text","string","str","unix","command","cmd","output","csv","shell","sh","term","table"],"dependencies":{"escape-string-regexp":"^1.0.3","execall":"^1.0.0","repeating":"^1.1.3","split-at":"^1.1.0"},"devDependencies":{"ava":"0.0.4"},"gitHead":"c2a3c767d26a52cfb741331df4db006061963528","bugs":{"url":"https://github.com/sindresorhus/parse-columns/issues"},"homepage":"https://github.com/sindresorhus/parse-columns","_id":"parse-columns@1.1.0","_shasum":"8a54ca0d11043c63bbe9bcf10267a6e1516aaeab","_from":".","_npmVersion":"2.11.2","_nodeVersion":"0.12.5","_npmUser":{"name":"sindresorhus","email":"sindresorhus@gmail.com"},"dist":{"shasum":"8a54ca0d11043c63bbe9bcf10267a6e1516aaeab","size":2939,"noattachment":false,"key":"/parse-columns/-/parse-columns-1.1.0.tgz","tarball":"http://name.csiicloud.com:7001/parse-columns/download/parse-columns-1.1.0.tgz"},"maintainers":[{"name":"sindresorhus","email":""}],"directories":{},"publish_time":1436274766223,"_hasShrinkwrap":false,"_cnpm_publish_time":1436274766223,"_cnpmcore_publish_time":"2021-12-16T20:39:26.102Z"},"1.0.1":{"name":"parse-columns","version":"1.0.1","description":"Parse text columns, like the output of unix commands","license":"MIT","repository":{"type":"git","url":"https://github.com/sindresorhus/parse-columns"},"author":{"name":"Sindre Sorhus","email":"sindresorhus@gmail.com","url":"sindresorhus.com"},"engines":{"node":">=0.10.0"},"scripts":{"test":"node test.js"},"files":["index.js"],"keywords":["parse","parser","columns","column","col","row","text","string","str","unix","command","cmd","output","csv","shell","sh","term","table"],"dependencies":{"escape-string-regexp":"^1.0.3","execall":"^1.0.0","repeating":"^1.1.3","split-at":"^1.1.0"},"devDependencies":{"ava":"0.0.4"},"gitHead":"f9fa6e49d28a5721e8e25b208d93b230a252941f","bugs":{"url":"https://github.com/sindresorhus/parse-columns/issues"},"homepage":"https://github.com/sindresorhus/parse-columns","_id":"parse-columns@1.0.1","_shasum":"6575c70828f2a8e0085b20eb9273a31c583b01a6","_from":".","_npmVersion":"2.11.2","_nodeVersion":"0.12.5","_npmUser":{"name":"sindresorhus","email":"sindresorhus@gmail.com"},"dist":{"shasum":"6575c70828f2a8e0085b20eb9273a31c583b01a6","size":2812,"noattachment":false,"key":"/parse-columns/-/parse-columns-1.0.1.tgz","tarball":"http://name.csiicloud.com:7001/parse-columns/download/parse-columns-1.0.1.tgz"},"maintainers":[{"name":"sindresorhus","email":""}],"directories":{},"publish_time":1435699424496,"_hasShrinkwrap":false,"_cnpm_publish_time":1435699424496,"_cnpmcore_publish_time":"2021-12-16T20:39:26.326Z"},"1.0.0":{"name":"parse-columns","version":"1.0.0","description":"Parse text columns, like the output of unix commands","license":"MIT","repository":{"type":"git","url":"https://github.com/sindresorhus/parse-columns"},"author":{"name":"Sindre Sorhus","email":"sindresorhus@gmail.com","url":"sindresorhus.com"},"engines":{"node":">=0.10.0"},"scripts":{"test":"node test.js"},"files":["index.js"],"keywords":["parse","parser","columns","column","col","row","text","string","str","unix","command","cmd","output","csv","shell","sh","term","table"],"dependencies":{"escape-string-regexp":"^1.0.3","execall":"^1.0.0","split-at":"^1.1.0"},"devDependencies":{"ava":"0.0.4"},"gitHead":"b2275b3d071a5aecb02c928ea15dfacfc9ae2ceb","bugs":{"url":"https://github.com/sindresorhus/parse-columns/issues"},"homepage":"https://github.com/sindresorhus/parse-columns","_id":"parse-columns@1.0.0","_shasum":"9e82ff7621f817f3e261dcf7f155fe88ad330022","_from":".","_npmVersion":"2.10.1","_nodeVersion":"0.12.4","_npmUser":{"name":"sindresorhus","email":"sindresorhus@gmail.com"},"dist":{"shasum":"9e82ff7621f817f3e261dcf7f155fe88ad330022","size":2685,"noattachment":false,"key":"/parse-columns/-/parse-columns-1.0.0.tgz","tarball":"http://name.csiicloud.com:7001/parse-columns/download/parse-columns-1.0.0.tgz"},"maintainers":[{"name":"sindresorhus","email":""}],"directories":{},"publish_time":1434450439557,"_hasShrinkwrap":false,"_cnpm_publish_time":1434450439557,"_cnpmcore_publish_time":"2021-12-16T20:39:26.533Z"}},"readme":"# parse-columns\n\n> Parse text columns, like the output of Unix commands\n\n## Install\n\n```sh\nnpm install parse-columns\n```\n\n## Usage\n\n```\n$ df -kP\nFilesystem 1024-blocks      Used Available Capacity  Mounted on\n/dev/disk1   487350400 467871060  19223340    97%    /\ndevfs              185       185         0   100%    /dev\nmap -hosts           0         0         0   100%    /net\n```\n\n```js\nimport {promisify} from 'node:util';\nimport childProcess from 'node:child_process';\nimport parseColumns from 'parse-columns';\n\nconst execFileP = promisify(childProcess.execFile);\n\nconst {stdout} = await execFileP('df', ['-kP']);\n\nconsole.log(parseColumns(stdout, {\n\ttransform: (item, header, columnIndex) => {\n\t\t// Coerce elements in column index 1 to 3 to a number\n\t\tif (columnIndex >= 1 && columnIndex <= 3) {\n\t\t\treturn Number(item);\n\t\t}\n\n\t\treturn item;\n\t}\n}));\n/*\n[\n\t{\n\t\tFilesystem: '/dev/disk1',\n\t\t'1024-blocks': 487350400,\n\t\tUsed: 467528020,\n\t\tAvailable: 19566380,\n\t\tCapacity: '96%',\n\t\t'Mounted on': '/'\n\t},\n\t…\n]\n*/\n```\n\n## API\n\n### parseColumns(textColumns, options?)\n\n#### textColumns\n\nType: `string`\n\nThe text columns to parse.\n\n#### options\n\nType: `object`\n\n##### separator\n\nType: `string`\nDefault: `' '`\n\nSeparator to split columns on.\n\n##### headers\n\nType: `string[]`\n\nHeaders to use instead of the existing ones.\n\n##### transform\n\nType: `Function`\n\nTransform elements.\n\nUseful for being able to cleanup or change the type of elements.\n\nThe supplied function gets the following arguments and is expected to return the element:\n\n- `element` *(string)*\n- `header` *(string)*\n- `columnIndex` *(number)*\n- `rowIndex` *(number)*\n\n## Related\n\n- [parse-columns-cli](https://github.com/sindresorhus/parse-columns-cli) - CLI for this module\n","_attachments":{},"homepage":"https://github.com/sindresorhus/parse-columns#readme","bugs":{"url":"https://github.com/sindresorhus/parse-columns/issues"},"license":"MIT"}