csvstack - manual page for csvstack 1.0.7
usage: csvstack [-h] [-d DELIMITER] [-t] [-q QUOTECHAR] [-u
{0,1,2,3}] [-b]
- [-p ESCAPECHAR] [-z FIELD_SIZE_LIMIT] [-e ENCODING] [-S] [-H] [-K
SKIP_LINES] [-v] [-l] [--zero] [-V] [-g GROUPS] [-n GROUP_NAME]
[--filenames] [FILE ...]
Stack up the rows from multiple CSV files, optionally adding a
grouping value. Files are assumed to have the same columns in the same
order.
- FILE
- The CSV file(s) to operate on. If omitted, will accept input as piped data
via STDIN.
- -h, --help
- show this help message and exit
- -d DELIMITER,
--delimiter DELIMITER
- Delimiting character of the input CSV file.
- -t, --tabs
- Specify that the input CSV file is delimited with tabs. Overrides
"-d".
- -q QUOTECHAR,
--quotechar QUOTECHAR
- Character used to quote strings in the input CSV file.
- -u {0,1,2,3},
--quoting {0,1,2,3}
- Quoting style used in the input CSV file. 0 = Quote Minimal, 1 = Quote
All, 2 = Quote Non-numeric, 3 = Quote None.
- -b,
--no-doublequote
- Whether or not double quotes are doubled in the input CSV file.
- -p ESCAPECHAR,
--escapechar ESCAPECHAR
- Character used to escape the delimiter if --quoting 3 ("Quote
None") is specified and to escape the QUOTECHAR if
--no-doublequote is specified.
- -z FIELD_SIZE_LIMIT,
--maxfieldsize FIELD_SIZE_LIMIT
- Maximum length of a single field in the input CSV file.
- -e ENCODING,
--encoding ENCODING
- Specify the encoding of the input CSV file.
- -S,
--skipinitialspace
- Ignore whitespace immediately following the delimiter.
- -H,
--no-header-row
- Specify that the input CSV file has no header row. Will create default
headers (a,b,c,...).
- -K SKIP_LINES,
--skip-lines SKIP_LINES
- Specify the number of initial lines to skip before the header row (e.g.
comments, copyright notices, empty rows).
- -v, --verbose
- Print detailed tracebacks when errors occur.
- -l,
--linenumbers
- Insert a column of line numbers at the front of the output. Useful when
piping to grep or as a simple primary key.
- --zero
- When interpreting or displaying column numbers, use zero-based numbering
instead of the default 1-based numbering.
- -V, --version
- Display version information and exit.
- -g GROUPS, --groups
GROUPS
- A comma-separated list of values to add as "grouping factors",
one per CSV being stacked. These are added to the output as a new column.
You may specify a name for the new column using the -n flag.
- -n GROUP_NAME,
--group-name GROUP_NAME
- A name for the grouping column, e.g. "year". Only used when also
specifying -g.
- --filenames
- Use the filename of each input file as its grouping value. When specified,
-g will be ignored.
The full documentation for csvstack is maintained as a
Texinfo manual. If the info and csvstack programs are properly
installed at your site, the command
- info csvstack
should give you access to the complete manual.