datatools/csvcols.1.html at main · caltechlibrary/datatools · GitHub

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
<!DOCTYPE html>
<html lang="en-US">
<head>
    <title>datatools</title>
    <link rel="stylesheet" href="https://caltechlibrary.github.io/css/site.css">
    <link rel="stylesheet" href="https://media.library.caltech.edu/cl-webcomponents/css/code-blocks.css">
    <script type="module" src="https://media.library.caltech.edu/cl-webcomponents/copyToClipboard.js"></script>
    <script type="module" src="https://media.library.caltech.edu/cl-webcomponents/footer-global.js"></script>
</head>
<body>
<header>
<a href="https://library.caltech.edu"><img src="https://media.library.caltech.edu/assets/caltechlibrary-logo.png" alt="Caltech Library logo"></a>
</header>
<nav>
<ul>
    <li><a href="/">Home</a></li>
    <li><a href="index.html">README</a></li>
    <li><a href="LICENSE">LICENSE</a></li>
    <li><a href="INSTALL.html">INSTALL</a></li>
    <li><a href="user_manual.html">User Manual</a></li>
    <li><a href="about.html">About</a></li>
    <li><a href="search.html">Search</a></li>
    <li><a href="https://github.com/caltechlibrary/datatools">GitHub</a></li>
</ul>
</nav>
<section>
<h1 id="name">NAME</h1>
<p>csvcols</p>
<h1 id="synopsis">SYNOPSIS</h1>
<p>csvcols <a href="#options">OPTIONS</a> [ARGS_AS_COL_VALUES]</p>
<h1 id="description">DESCRIPTION</h1>
<p>csvcols converts a set of command line args into columns output in
CSV format.</p>
<p>It can also be used CSV input rows and rendering only the column
numbers listed on the commandline (first column is 1 not 0).</p>
<h1 id="options">OPTIONS</h1>
<dl>
<dt>-help</dt>
<dd>
display help
</dd>
<dt>-license</dt>
<dd>
display license
</dd>
<dt>-version</dt>
<dd>
display version
</dd>
<dt>-col, -cols</dt>
<dd>
output specified columns (e.g. -col 1,12:14,2,4))
</dd>
<dt>-d, -delimiter</dt>
<dd>
set the input delimiter character
</dd>
<dt>-i, -input</dt>
<dd>
input filename
</dd>
<dt>-o, -output</dt>
<dd>
output filename
</dd>
<dt>-od, -output-delimiter</dt>
<dd>
set the output delimiter character
</dd>
<dt>-quiet</dt>
<dd>
suppress error messages
</dd>
<dt>-skip-header-row</dt>
<dd>
skip the header row
</dd>
<dt>-trim-leading-space</dt>
<dd>
trim leading space in field(s) for CSV input
</dd>
<dt>-use-lazy-quotes</dt>
<dd>
use lazy quotes on CSV input
</dd>
<dt>-uuid</dt>
<dd>
add a prefix row with generated UUID cell
</dd>
<dt>-crlf</dt>
<dd>
use a CRLF for end of line (EOL) on output (defualts to true on Windows)
</dd>
</dl>
<h1 id="examples">EXAMPLES</h1>
<p>Simple usage of building a CSV file one row at a time.</p>
<pre><code>    csvcols one two three &gt; 3col.csv
    csvcols 1 2 3 &gt;&gt; 3col.csv
    cat 3col.csv</code></pre>
<p>Example parsing a pipe delimited string into a CSV line</p>
<pre><code>    csvcols -d &quot;|&quot; &quot;one|two|three&quot; &gt; 3col.csv
    csvcols -delimiter &quot;|&quot; &quot;1|2|3&quot; &gt;&gt; 3col.csv
    cat 3col.csv</code></pre>
<p>Using a pipe filter a 3 column CSV for columns 1 and 3 into
2col.csv</p>
<pre><code>    cat 3col.csv | csvcols -col 1,3 &gt; 2col.csv</code></pre>
<p>Using options filter a 3 column CSV file for columns 1,3 into
2col.csv</p>
<pre><code>    csvcols -i 3col.csv -col 1,3 -o 2col.csv</code></pre>
<p>csvcols 1.3.5</p>
</section>
<footer-global></footer-global>
</body>
</html>