datatools is a collection of command line programs run from a shell like Bash.
This is generalized instructions for a release.
Compiled versions are available for Mac OS X (amd64 and M1 processor, macos-amd64 and macos-arm64), Linux (amd64 process, linux-amd64), Windows (amd64 and arm64 processor, windows-amd64 and windows-arm64) and Rapsberry Pi (arm7 processor, raspbian-arm7)
VERSION_NUMBER is a symantic version number (e.g. v0.1.2)
For all the released version go to the project page on Github and click latest release
https://github.com/caltechlibrary/datatools/releases/latest
Platform | Zip Filename |
---|---|
Windows | datatools-VERSION_NUMBER-windows-amd64.zip |
Windows | datatools-VERSION_NUMBER-windows-arm64.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 |
Here’s an example of the commands run in the Terminal App after downloading the zip file.
cd Downloads/
unzip datatools-*-macos-amd64.zip
mkdir -p $HOME/bin
mv -v bin/* $HOME/bin/
export PATH=$HOME/bin:$PATH
csvfind -version
cd Downloads/
unzip datatools-*-macos-arm64.zip
mkdir -p $HOME/bin
mv -v bin/* $HOME/bin/
export PATH=$HOME/bin:$PATH
csvfind -version
(Assumes you’re working from Bash as provided by Linux Subsystem for Windows)
Here’s an example of the commands run in from the Bash shell on Windows 10 after downloading the zip file.
cd Downloads/
unzip datatools-*-windows-amd64.zip
mkdir -p $HOME/bin
mv -v bin/* $HOME/bin/
export PATH=$HOME/bin:$PATH
csvfind -version
cd Downloads/
unzip datatools-*-windows-arm64.zip
mkdir -p $HOME/bin
mv -v bin/* $HOME/bin/
export PATH=$HOME/bin:$PATH
csvfind -version
Here’s an example of the commands run in from the Bash shell after downloading the zip file.
cd Downloads/
unzip datatools-*-linux-amd64.zip
mkdir -p $HOME/bin
cp -v bin/* $HOME/bin/
export PATH=$HOME/bin:$PATH
csvfind -version
Released version is for a Raspberry Pi 2 or later use (i.e. requires ARM 7 support).
Here’s an example of the commands run in from the Bash shell after downloading the zip file.
cd Downloads/
unzip datatools-*-raspberry_pi_os-arm7.zip
mkdir -p $HOME/bin
cp -v bin/* $HOME/bin/
export PATH=$HOME/bin:$PATH
csvfind -version
datatools is “go gettable” if you have previously gotten xlsx v1.0.5 package from github.com/tealeg/xlsx. The datatools package does not support versions v2.x and greater of xlsx. Below are the steps I use today with “go get” command to download the dependant packages as well as datatools’s source code.
Setting up the right version of xlsx for datatools
cd
go get github.com/tealeg/xlsx
cd src/github.com/tealeg
git checkout v1.0.5
cd
Using go get
to install datatools using v1.0.5 of xlsx.
go get github.com/caltechlibrary/datatools/...
Or clone the repository and then compile
cd
git clone https://github.com/caltechlibrary/datatools src/github.com/caltechlibrary/datatools
cd src/github.com/caltechlibrary/datatools
make
make test
make install