prep for v1.0.4 release

Author: rsdoiel

INSTALL.md

@@ -20,13 +20,13 @@ For all the released version go to the project page on Github and click latest r
 >    https://github.com/caltechlibrary/datatools/releases/latest
 
 
-| Platform    | Zip Filename                               |
-|-------------|--------------------------------------------|
-| Windows     | datatools-VERSION_NUMBER-windows-amd64.zip |
-| Mac OS X    | datatools-VERSION_NUMBER-macos-amd64.zip  |
-| Mac OS X    | datatools-VERSION_NUMBER-macos-arm64.zip  |
-| Linux/Intel | datatools-VERSION_NUMBER-linux-amd64.zip   |
-| Raspbery Pi | datatools-VERSION_NUMBER-raspbian-arm7.zip |
+| Platform       | Zip Filename                                      |
+|----------------|---------------------------------------------------|
+| Windows        | datatools-VERSION_NUMBER-windows-amd64.zip        |
+| Mac OS X       | datatools-VERSION_NUMBER-macos-amd64.zip          |
+| Mac OS X       | datatools-VERSION_NUMBER-macos-arm64.zip          |
+| Linux/Intel    | datatools-VERSION_NUMBER-linux-amd64.zip          |
+| Raspbery Pi OS | datatools-VERSION_NUMBER-raspberry_pi_os-arm7.zip |
 
 
 The basic recipe
@@ -116,7 +116,7 @@ downloading the zip file.
 
 ```shell
     cd Downloads/
-    unzip datatools-*-raspbian-arm7.zip
+    unzip datatools-*-raspberry_pi_os-arm7.zip
     mkdir -p $HOME/bin
     cp -v bin/* $HOME/bin/
     export PATH=$HOME/bin:$PATH

Makefile

@@ -85,35 +85,35 @@ uninstall: .FORCE
 dist/linux-amd64: $(PROGRAMS)
 	@mkdir -p dist/bin
 	@for FNAME in $(PROGRAMS); do env  GOOS=linux GOARCH=amd64 go build -o dist/bin/$$FNAME cmd/$$FNAME/*.go; done
-	@cd dist && zip -r $(PROJECT)-$(VERSION)-linux-amd64.zip LICENSE codemeta.json CITATION.cff *.md bin/* docs/* how-to/* demos/*
+	@cd dist && zip -r $(PROJECT)-v$(VERSION)-linux-amd64.zip LICENSE codemeta.json CITATION.cff *.md bin/* docs/* how-to/* demos/*
 	@rm -fR dist/bin
 
 
 dist/macos-amd64: $(PROGRAMS)
 	@mkdir -p dist/bin
 	@for FNAME in $(PROGRAMS); do env GOOS=darwin GOARCH=amd64 go build -o dist/bin/$$FNAME cmd/$$FNAME/*.go; done
-	@cd dist && zip -r $(PROJECT)-$(VERSION)-macos-amd64.zip LICENSE codemeta.json CITATION.cff *.md bin/* docs/* how-to/* demos/*
+	@cd dist && zip -r $(PROJECT)-v$(VERSION)-macos-amd64.zip LICENSE codemeta.json CITATION.cff *.md bin/* docs/* how-to/* demos/*
 	@rm -fR dist/bin
 
 
 dist/macos-arm64: $(PROGRAMS)
 	@mkdir -p dist/bin
 	@for FNAME in $(PROGRAMS); do env GOOS=darwin GOARCH=arm64 go build -o dist/bin/$$FNAME cmd/$$FNAME/*.go; done
-	@cd dist && zip -r $(PROJECT)-$(VERSION)-macos-arm64.zip LICENSE codemeta.json CITATION.cff *.md bin/* docs/* how-to/* demos/*
+	@cd dist && zip -r $(PROJECT)-v$(VERSION)-macos-arm64.zip LICENSE codemeta.json CITATION.cff *.md bin/* docs/* how-to/* demos/*
 	@rm -fR dist/bin
 
 
 dist/windows-amd64: $(PROGRAMS)
 	@mkdir -p dist/bin
 	@for FNAME in $(PROGRAMS); do env GOOS=windows GOARCH=amd64 go build -o dist/bin/$$FNAME.exe cmd/$$FNAME/*.go; done
-	@cd dist && zip -r $(PROJECT)-$(VERSION)-windows-amd64.zip LICENSE codemeta.json CITATION.cff *.md bin/* docs/* how-to/* demos/*
+	@cd dist && zip -r $(PROJECT)-v$(VERSION)-windows-amd64.zip LICENSE codemeta.json CITATION.cff *.md bin/* docs/* how-to/* demos/*
 	@rm -fR dist/bin
 
 
 dist/raspbian-arm7: $(PROGRAMS)
 	@mkdir -p dist/bin
 	@for FNAME in $(PROGRAMS); do env GOOS=linux GOARCH=arm GOARM=7 go build -o dist/bin/$$FNAME cmd/$$FNAME/*.go; done
-	@cd dist && zip -r $(PROJECT)-$(VERSION)-raspberry_pi_os-arm7.zip LICENSE codemeta.json CITATION.cff *.md bin/* docs/* how-to/* demos/*
+	@cd dist && zip -r $(PROJECT)-v$(VERSION)-raspberry_pi_os-arm7.zip LICENSE codemeta.json CITATION.cff *.md bin/* docs/* how-to/* demos/*
 	@rm -fR dist/bin
 
 distribute_docs:

how-to/jsoncols/index.html

@@ -43,7 +43,7 @@ <h1 id="using-jsoncols">
 If myblob.json contained
 </p>
 <div id="cb1" class="sourceCode">
-<pre class="sourceCode json"><code class="sourceCode json"><span id="cb1-1"><a href="#cb1-1"></a>    <span class="fu">{</span><span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;email&quot;</span><span class="fu">:</span><span class="st">&quot;[email protected]&quot;</span><span class="fu">,</span> <span class="dt">&quot;age&quot;</span><span class="fu">:</span> <span class="dv">42</span><span class="fu">}</span></span></code></pre>
+<pre class="sourceCode json"><code class="sourceCode json"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true"></a>    <span class="fu">{</span><span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;email&quot;</span><span class="fu">:</span><span class="st">&quot;[email protected]&quot;</span><span class="fu">,</span> <span class="dt">&quot;age&quot;</span><span class="fu">:</span> <span class="dv">42</span><span class="fu">}</span></span></code></pre>
 </div>
 <p>
 Getting just the name could be done with

how-to/jsonjoin/index.html

@@ -50,8 +50,8 @@ <h1 id="using-jsonjoin">
 profile.json contains
 </p>
 <div id="cb2" class="sourceCode">
-<pre class="sourceCode json"><code class="sourceCode json"><span id="cb2-1"><a href="#cb2-1"></a>   <span class="fu">{</span> <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;bio&quot;</span><span class="fu">:</span> <span class="st">&quot;World renowned geophysist.&quot;</span><span class="fu">,</span></span>
-<span id="cb2-2"><a href="#cb2-2"></a>     <span class="dt">&quot;email&quot;</span><span class="fu">:</span> <span class="st">&quot;[email protected]&quot;</span> <span class="fu">}</span></span></code></pre>
+<pre class="sourceCode json"><code class="sourceCode json"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true"></a>   <span class="fu">{</span> <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;bio&quot;</span><span class="fu">:</span> <span class="st">&quot;World renowned geophysist.&quot;</span><span class="fu">,</span></span>
+<span id="cb2-2"><a href="#cb2-2" aria-hidden="true"></a>     <span class="dt">&quot;email&quot;</span><span class="fu">:</span> <span class="st">&quot;[email protected]&quot;</span> <span class="fu">}</span></span></code></pre>
 </div>
 <p>
 A simple join of person.json with profile.json (note the -create option)
@@ -61,12 +61,12 @@ <h1 id="using-jsonjoin">
 would yield and object like
 </p>
 <div id="cb4" class="sourceCode">
-<pre class="sourceCode json"><code class="sourceCode json"><span id="cb4-1"><a href="#cb4-1"></a>   <span class="fu">{</span></span>
-<span id="cb4-2"><a href="#cb4-2"></a>     <span class="dt">&quot;person&quot;</span><span class="fu">:</span>  <span class="fu">{</span> <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;email&quot;</span><span class="fu">:</span><span class="st">&quot;[email protected]&quot;</span><span class="fu">,</span></span>
-<span id="cb4-3"><a href="#cb4-3"></a>                <span class="dt">&quot;age&quot;</span><span class="fu">:</span> <span class="dv">42</span><span class="fu">},</span></span>
-<span id="cb4-4"><a href="#cb4-4"></a>     <span class="dt">&quot;profile&quot;</span><span class="fu">:</span> <span class="fu">{</span> <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;bio&quot;</span><span class="fu">:</span> <span class="st">&quot;World renowned geophysist.&quot;</span><span class="fu">,</span></span>
-<span id="cb4-5"><a href="#cb4-5"></a>                  <span class="dt">&quot;email&quot;</span><span class="fu">:</span> <span class="st">&quot;[email protected]&quot;</span> <span class="fu">}</span></span>
-<span id="cb4-6"><a href="#cb4-6"></a>   <span class="fu">}</span></span></code></pre>
+<pre class="sourceCode json"><code class="sourceCode json"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true"></a>   <span class="fu">{</span></span>
+<span id="cb4-2"><a href="#cb4-2" aria-hidden="true"></a>     <span class="dt">&quot;person&quot;</span><span class="fu">:</span>  <span class="fu">{</span> <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;email&quot;</span><span class="fu">:</span><span class="st">&quot;[email protected]&quot;</span><span class="fu">,</span></span>
+<span id="cb4-3"><a href="#cb4-3" aria-hidden="true"></a>                <span class="dt">&quot;age&quot;</span><span class="fu">:</span> <span class="dv">42</span><span class="fu">},</span></span>
+<span id="cb4-4"><a href="#cb4-4" aria-hidden="true"></a>     <span class="dt">&quot;profile&quot;</span><span class="fu">:</span> <span class="fu">{</span> <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;bio&quot;</span><span class="fu">:</span> <span class="st">&quot;World renowned geophysist.&quot;</span><span class="fu">,</span></span>
+<span id="cb4-5"><a href="#cb4-5" aria-hidden="true"></a>                  <span class="dt">&quot;email&quot;</span><span class="fu">:</span> <span class="st">&quot;[email protected]&quot;</span> <span class="fu">}</span></span>
+<span id="cb4-6"><a href="#cb4-6" aria-hidden="true"></a>   <span class="fu">}</span></span></code></pre>
 </div>
 <p>
 Likewise if you want to treat person.json as the root object and add profile.json as a branch try
@@ -80,11 +80,11 @@ <h1 id="using-jsonjoin">
 this yields an object like
 </p>
 <div id="cb7" class="sourceCode">
-<pre class="sourceCode json"><code class="sourceCode json"><span id="cb7-1"><a href="#cb7-1"></a>   <span class="fu">{</span></span>
-<span id="cb7-2"><a href="#cb7-2"></a>     <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;email&quot;</span><span class="fu">:</span><span class="st">&quot;[email protected]&quot;</span><span class="fu">,</span> <span class="dt">&quot;age&quot;</span><span class="fu">:</span> <span class="dv">42</span><span class="fu">,</span></span>
-<span id="cb7-3"><a href="#cb7-3"></a>     <span class="dt">&quot;profile&quot;</span><span class="fu">:</span> <span class="fu">{</span> <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;bio&quot;</span><span class="fu">:</span> <span class="st">&quot;World renowned geophysist.&quot;</span><span class="fu">,</span></span>
-<span id="cb7-4"><a href="#cb7-4"></a>                  <span class="dt">&quot;email&quot;</span><span class="fu">:</span> <span class="st">&quot;[email protected]&quot;</span> <span class="fu">}</span></span>
-<span id="cb7-5"><a href="#cb7-5"></a>   <span class="fu">}</span></span></code></pre>
+<pre class="sourceCode json"><code class="sourceCode json"><span id="cb7-1"><a href="#cb7-1" aria-hidden="true"></a>   <span class="fu">{</span></span>
+<span id="cb7-2"><a href="#cb7-2" aria-hidden="true"></a>     <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;email&quot;</span><span class="fu">:</span><span class="st">&quot;[email protected]&quot;</span><span class="fu">,</span> <span class="dt">&quot;age&quot;</span><span class="fu">:</span> <span class="dv">42</span><span class="fu">,</span></span>
+<span id="cb7-3"><a href="#cb7-3" aria-hidden="true"></a>     <span class="dt">&quot;profile&quot;</span><span class="fu">:</span> <span class="fu">{</span> <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;bio&quot;</span><span class="fu">:</span> <span class="st">&quot;World renowned geophysist.&quot;</span><span class="fu">,</span></span>
+<span id="cb7-4"><a href="#cb7-4" aria-hidden="true"></a>                  <span class="dt">&quot;email&quot;</span><span class="fu">:</span> <span class="st">&quot;[email protected]&quot;</span> <span class="fu">}</span></span>
+<span id="cb7-5"><a href="#cb7-5" aria-hidden="true"></a>   <span class="fu">}</span></span></code></pre>
 </div>
 <p>
 You can modify this behavor with -update or -overwrite. Both options are order dependant (i.e. not associative, A update B does not necessarily equal B update A).
@@ -105,8 +105,8 @@ <h1 id="using-jsonjoin">
 would yield
 </p>
 <div id="cb9" class="sourceCode">
-<pre class="sourceCode json"><code class="sourceCode json"><span id="cb9-1"><a href="#cb9-1"></a>   <span class="fu">{</span> <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;email&quot;</span><span class="fu">:</span><span class="st">&quot;[email protected]&quot;</span><span class="fu">,</span> <span class="dt">&quot;age&quot;</span><span class="fu">:</span> <span class="dv">42</span><span class="fu">,</span></span>
-<span id="cb9-2"><a href="#cb9-2"></a>     <span class="dt">&quot;bio&quot;</span><span class="fu">:</span> <span class="st">&quot;World renowned geophysist.&quot;</span> <span class="fu">}</span></span></code></pre>
+<pre class="sourceCode json"><code class="sourceCode json"><span id="cb9-1"><a href="#cb9-1" aria-hidden="true"></a>   <span class="fu">{</span> <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;email&quot;</span><span class="fu">:</span><span class="st">&quot;[email protected]&quot;</span><span class="fu">,</span> <span class="dt">&quot;age&quot;</span><span class="fu">:</span> <span class="dv">42</span><span class="fu">,</span></span>
+<span id="cb9-2"><a href="#cb9-2" aria-hidden="true"></a>     <span class="dt">&quot;bio&quot;</span><span class="fu">:</span> <span class="st">&quot;World renowned geophysist.&quot;</span> <span class="fu">}</span></span></code></pre>
 </div>
 <p>
 Running
@@ -116,9 +116,9 @@ <h1 id="using-jsonjoin">
 would yield
 </p>
 <div id="cb11" class="sourceCode">
-<pre class="sourceCode json"><code class="sourceCode json"><span id="cb11-1"><a href="#cb11-1"></a>   <span class="fu">{</span> <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span>  <span class="dt">&quot;age&quot;</span><span class="fu">:</span> <span class="dv">42</span><span class="fu">,</span></span>
-<span id="cb11-2"><a href="#cb11-2"></a>     <span class="dt">&quot;bio&quot;</span><span class="fu">:</span> <span class="st">&quot;World renowned geophysist.&quot;</span><span class="fu">,</span></span>
-<span id="cb11-3"><a href="#cb11-3"></a>     <span class="dt">&quot;email&quot;</span><span class="fu">:</span> <span class="st">&quot;[email protected]&quot;</span> <span class="fu">}</span></span></code></pre>
+<pre class="sourceCode json"><code class="sourceCode json"><span id="cb11-1"><a href="#cb11-1" aria-hidden="true"></a>   <span class="fu">{</span> <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span>  <span class="dt">&quot;age&quot;</span><span class="fu">:</span> <span class="dv">42</span><span class="fu">,</span></span>
+<span id="cb11-2"><a href="#cb11-2" aria-hidden="true"></a>     <span class="dt">&quot;bio&quot;</span><span class="fu">:</span> <span class="st">&quot;World renowned geophysist.&quot;</span><span class="fu">,</span></span>
+<span id="cb11-3"><a href="#cb11-3" aria-hidden="true"></a>     <span class="dt">&quot;email&quot;</span><span class="fu">:</span> <span class="st">&quot;[email protected]&quot;</span> <span class="fu">}</span></span></code></pre>
 </div>
 <p>
 Running
@@ -128,8 +128,8 @@ <h1 id="using-jsonjoin">
 would yield
 </p>
 <div id="cb13" class="sourceCode">
-<pre class="sourceCode json"><code class="sourceCode json"><span id="cb13-1"><a href="#cb13-1"></a>   <span class="fu">{</span> <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;email&quot;</span><span class="fu">:</span><span class="st">&quot;[email protected]&quot;</span><span class="fu">,</span> <span class="dt">&quot;age&quot;</span><span class="fu">:</span> <span class="dv">42</span><span class="fu">,</span></span>
-<span id="cb13-2"><a href="#cb13-2"></a>     <span class="dt">&quot;bio&quot;</span><span class="fu">:</span> <span class="st">&quot;World renowned geophysist.&quot;</span> <span class="fu">}</span></span></code></pre>
+<pre class="sourceCode json"><code class="sourceCode json"><span id="cb13-1"><a href="#cb13-1" aria-hidden="true"></a>   <span class="fu">{</span> <span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;email&quot;</span><span class="fu">:</span><span class="st">&quot;[email protected]&quot;</span><span class="fu">,</span> <span class="dt">&quot;age&quot;</span><span class="fu">:</span> <span class="dv">42</span><span class="fu">,</span></span>
+<span id="cb13-2"><a href="#cb13-2" aria-hidden="true"></a>     <span class="dt">&quot;bio&quot;</span><span class="fu">:</span> <span class="st">&quot;World renowned geophysist.&quot;</span> <span class="fu">}</span></span></code></pre>
 </div>
 </section>
 

how-to/jsonmunge/index.html

@@ -43,7 +43,7 @@ <h1 id="using-jsonmunge">
 If person.json contained
 </p>
 <div id="cb1" class="sourceCode">
-<pre class="sourceCode json"><code class="sourceCode json"><span id="cb1-1"><a href="#cb1-1"></a>   <span class="fu">{</span><span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;email&quot;</span><span class="fu">:</span><span class="st">&quot;[email protected]&quot;</span><span class="fu">,</span> <span class="dt">&quot;age&quot;</span><span class="fu">:</span> <span class="dv">42</span><span class="fu">}</span></span></code></pre>
+<pre class="sourceCode json"><code class="sourceCode json"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true"></a>   <span class="fu">{</span><span class="dt">&quot;name&quot;</span><span class="fu">:</span> <span class="st">&quot;Doe, Jane&quot;</span><span class="fu">,</span> <span class="dt">&quot;email&quot;</span><span class="fu">:</span><span class="st">&quot;[email protected]&quot;</span><span class="fu">,</span> <span class="dt">&quot;age&quot;</span><span class="fu">:</span> <span class="dv">42</span><span class="fu">}</span></span></code></pre>
 </div>
 <p>
 and the template, name.tmpl, contained