Quick Save

Author: rsdoiel

docs/csvrows.md

@@ -0,0 +1,63 @@
+
+# USAGE
+
+## csvrows [OPTIONS] [ARGS_AS_ROW_VALUES]
+
+## SYNOPSIS
+
+csvrows converts a set of command line args into rows of CSV formated output.
+It can also be used to filter or list specific rows of CSV input
+The first row is 1 not 0. Often row 1 is the header row and %!s(MISSING) makes it
+easy to output only the data rows.
+
+## OPTIONS
+
+	-d	set delimiter character
+	-delimiter	set delimiter character
+	-h	display help
+	-header	display the header row (alias for '-rows 1')
+	-help	display help
+	-i	input filename
+	-input	input filename
+	-l	display license
+	-license	display license
+	-o	output filename
+	-output	output filename
+	-row	output specified rows in order (e.g. -row 1,5,2:4))
+	-rows	output specified rows in order (e.g. -rows 1,5,2:4))
+	-skip-header-row	skip the header row (alias for -row 2:
+	-v	display version
+	-version	display version
+
+## EXAMPLES
+
+Simple usage of building a CSV file one rows at a time.
+
+```shell
+    csvrows "First,Second,Third" "one,two,three" > 4rows.csv
+    csvrows "ein,zwei,drei" "1,2,3" >> 4rows.csv
+    cat 4row.csv
+```
+
+Example parsing a pipe delimited string into a CSV line
+
+```shell
+    csvrows -d "|" "First,Second,Third|one,two,three" > 4rows.csv
+    csvrows -delimiter "|" "ein,zwei,drei|1,2,3" >> 4rows.csv
+    cat 4rows.csv
+```
+
+Filter a 10 row CSV file for rows 1,4,6 (top most row is one)
+
+```shell
+    cat 10row.csv | csvrows -row 1,4,6 > 3rows.csv
+```
+
+Filter a 10 row CSV file for rows 1,4,6 from file named "10row.csv"
+
+```shell
+    csvrows -i 10row.csv -row 1,4,6 > 3rows.csv
+```
+
+
+csvrows v0.0.14