manpages

in2csv(1)

IN2CSV(1) csvkit IN2CSV(1)

NAME

in2csv - in2csv Documentation

DESCRIPTION

Converts various tabular data formats into CSV.

Converting fixed width requires that you provide a schema file with the “-s” option. The schema file should have the following format:

column,start,length
name,0,30
birthday,30,10
age,40,3


The header line is required though the columns may be in any order:

usage: in2csv [-h] [-d DELIMITER] [-t] [-q QUOTECHAR] [-u {0,1,2,3}] [-b]


              [-p ESCAPECHAR] [-z FIELD_SIZE_LIMIT] [-e ENCODING] [-S] [-H]


              [-v] [-l] [--zero] [-V] [-f FILETYPE] [-s SCHEMA] [-k KEY] [-n]


              [--sheet SHEET] [-y SNIFF_LIMIT] [-I]


              [FILE]
Convert common, but less awesome, tabular data formats to CSV.
positional arguments:


  FILE                  The CSV file to operate on. If omitted, will accept


                        input on STDIN.
optional arguments:


  -h, --help            show this help message and exit


  -f FILETYPE, --format FILETYPE


                        The format of the input file. If not specified will be


                        inferred from the file type. Supported formats: csv,


                        dbf, fixed, geojson, json, ndjson, xls, xlsx.


  -s SCHEMA, --schema SCHEMA


                        Specify a CSV-formatted schema file for converting


                        fixed-width files. See documentation for details.


  -k KEY, --key KEY     Specify a top-level key to use look within for a list


                        of objects to be converted when processing JSON.


  -n, --names           Display sheet names from the input Excel file.


  --sheet SHEET         The name of the Excel sheet to operate on.


  --write-sheets WRITE_SHEETS


                        The names of the Excel sheets to write to files, or


                        "-" to write all sheets.


  -y SNIFF_LIMIT, --snifflimit SNIFF_LIMIT


                        Limit CSV dialect sniffing to the specified number of


                        bytes. Specify "0" to disable sniffing entirely.


  -I, --no-inference    Disable type inference when parsing CSV input.
Some command-line flags only pertain to specific input formats.


See also: ../common_arguments.

NOTE:

The “ndjson” format refers to “newline delimited JSON”, as used by many streaming APIs.


NOTE:

If an XLS looks identical to an XLSX when viewed in Excel, they may not be identical as CSV. For example, XLSX has an integer type, but XLS doesn’t. Numbers that look like integers from an XLS will have decimals in CSV, but those from an XLSX won’t.


NOTE:

To convert from HTML, consider messytables.


EXAMPLES

Convert the 2000 census geo headers file from fixed-width to CSV and from latin-1 encoding to utf8:

in2csv -e iso-8859-1 -f fixed -s examples/realdata/census_2000/census2000_geo_schema.csv examples/realdata/census_2000/usgeo_excerpt.upl


NOTE:

A library of fixed-width schemas is maintained in the ffs project:

https://github.com/wireservice/ffs



Convert an Excel .xls file:

in2csv examples/test.xls


Standardize the formatting of a CSV file (quoting, line endings, etc.):

in2csv examples/realdata/FY09_EDU_Recipients_by_State.csv


Fetch csvkit’s open issues from the GitHub API, convert the JSON response into a CSV and write it to a file:

curl https://api.github.com/repos/wireservice/csvkit/issues?state=open | in2csv -f json -v


Convert a DBase DBF file to an equivalent CSV:

in2csv examples/testdbf.dbf


AUTHOR

Christopher Groskopf

COPYRIGHT

2019, Christopher Groskopf

April 29, 2019 1.0.2