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 processor, macosx-amd64), Linux (amd64 process, linux-amd64), Windows (amd64 processor, windows-amd64) 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
Platform | Zip Filename |
---|---|
Windows | datatools-VERSION_NUMBER-windows-amd64.zip |
Mac OS X | datatools-VERSION_NUMBER-macosx-amd64.zip |
Linux/Intel | datatools-VERSION_NUMBER-linux-amd64.zip |
Raspbery Pi | datatools-VERSION_NUMBER-raspbian-arm7.zip |
export PATH="$HOME/bin:$PATH"
)Here’s an example of the commands run in the Terminal App after downloading the zip file.
cd Downloads/
unzip datatools-*-macosx-amd64.zip
mkdir -p $HOME/bin
cp -v bin/* $HOME/bin/
export PATH=$HOME/bin:$PATH
csvfind -version
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
cp -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-*-raspbian-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 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