-
Notifications
You must be signed in to change notification settings - Fork 10
/
Copy pathjsonjoin.1.html
107 lines (105 loc) · 3.24 KB
/
jsonjoin.1.html
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
<!DOCTYPE html>
<html>
<head>
<title>Caltech Library's Digital Library Development Sandbox</title>
<link href='https://fonts.googleapis.com/css?family=Open+Sans' rel='stylesheet' type='text/css'>
<link rel="stylesheet" href="/css/site.css">
</head>
<body>
<header>
<a href="http://library.caltech.edu"><img src="/assets/liblogo.gif" alt="Caltech Library logo"></a>
</header>
<nav>
<ul>
<li><a href="/">Home</a></li>
<li><a href="./">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="how-to/">Tutorials</a></li>
<li><a href="search.html">Search Docs</a></li>
<li><a href="about.html">About</a></li>
<li><a href="https://github.com/caltechlibrary/datatools">GitHub</a></li>
</ul>
</nav>
<section>
<h1 id="name">NAME</h1>
<p>jsonjoin</p>
<h1 id="synopsis">SYNOPSIS</h1>
<p>jsonjoin <a href="#options">OPTIONS</a> JSON_FILENAME [JSON_FILENAME
…]</p>
<h1 id="description">DESCRIPTION</h1>
<p>jsonjoin joins one or more JSON objects. By default the objects are
each assigned to an attribute corresponding with their filenames minus
the “.json” extension. If the object is read from standard input then
“_” is used as it’s attribute name.</p>
<p>If you use the update or overwrite options you will create a merged
object. The update option keeps the attribute value first encountered
and overwrite takes the last attribute value encountered.</p>
<h1 id="options">OPTIONS</h1>
<dl>
<dt>-help</dt>
<dd>
display help
</dd>
<dt>-license</dt>
<dd>
display license
</dd>
</dl>
<p>-version: display version</p>
<dl>
<dt>-nl, -newline</dt>
<dd>
if true add a trailing newline
</dd>
<dt>-o, -output</dt>
<dd>
output filename
</dd>
<dt>-p, -pretty</dt>
<dd>
pretty print output
</dd>
<dt>-quiet</dt>
<dd>
suppress error messages
</dd>
<dt>-create</dt>
<dd>
Create a root object placing each joined objects under their own
attribute
</dd>
<dt>-update</dt>
<dd>
update first object with the second object, ignore existing attributes
</dd>
<dt>-overwrite</dt>
<dd>
update first object with the second object, overwriting existing
attributes
</dd>
</dl>
<h1 id="examples">EXAMPLES</h1>
<p>This is an example of take “my1.json” and “my2.json” render
“my.json”</p>
<pre><code> jsonjoin my1.json my2.json >my.json</code></pre>
<p>my.json would have two attributes, “my1” and “my2” each with their
complete attributes.</p>
<p>Using the update option you can merge my1.json with any additional
attribute values found in m2.json.</p>
<pre><code> jsonjoin -update my1.json my2.json >my.json</code></pre>
<p>Using the overwrite option you can merge my1.json with my2.json
accepted as replacement values.</p>
<pre><code> jsonjoin -overwrite my1.json my2.json >my.json</code></pre>
</section>
<footer>
<span><h1><A href="http://caltech.edu">Caltech</a></h1></span>
<span>© 2023 <a href="https://www.library.caltech.edu/copyright">Caltech library</a></span>
<address>1200 E California Blvd, Mail Code 1-32, Pasadena, CA 91125-3200</address>
<span>Phone: <a href="tel:+1-626-395-3405">(626)395-3405</a></span>
<span><a href="mailto:[email protected]">Email Us</a></span>
<a class="cl-hide" href="sitemap.xml">Site Map</a>
</footer>
</body>
</html>