You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
*datatools* is a collection of command line programs run from a shell like Bash.
5
+
4
6
## Compiled version
5
7
6
-
*datatools* is a collection of command line programs run from a shell like Bash (or Powershell in Windows). If you download the repository a compiled version is in the dist directory. The compiled VERSION_NO matching your computer type and operating system can be copied to a bin directory in your PATH.
8
+
This is generalized instructions for a release.
9
+
10
+
Compiled versions are available for Mac OS X (amd64 processor, macosx-amd64), Linux (amd64 process, linux-amd64),
11
+
Windows (amd64 processor, windows-amd64) and Rapsberry Pi (arm7 processor, raspbian-arm7)
12
+
13
+
VERSION_NUMBER is a [symantic version number](http://semver.org/) (e.g. v0.1.2)
14
+
15
+
16
+
For all the released version go to the project page on Github and click latest release
| Raspbery Pi | datatools-VERSION_NUMBER-raspbian-arm7.zip | raspbian_arm7 |
27
+
28
+
## The basic recipe
29
+
30
+
+ Find the Zip file listed matching the architecture you're running and download it
31
+
+ (e.g. if you're on a Windows 10 laptop/Surface with a amd64 style CPU you'd choose the Zip file with "windows-amd64" in the name).
32
+
+ Download the zip file and unzip the file.
33
+
+ Copy the contents of the folder named "bin" to a folder that is in your path
34
+
+ (e.g. "$HOME/bin" is common).
35
+
+ Adjust your PATH if needed
36
+
+ (e.g. `export PATH="$HOME/bin:$PATH"`)
37
+
+ Test
7
38
8
-
Compiled versions are available for Mac OS X (amd64 processor), Linux (amd64), Windows (amd64) and Rapsberry Pi (both ARM6 and ARM7)
9
39
10
40
### Mac OS X
11
41
12
-
1. Download **datatools-VERSION_NO-release.zip** from [https://github.com/caltechlibrary/datatools/releases/latest](https://github.com/caltechlibrary/datatools/releases/latest)
13
-
2. Open a finder window, find and unzip **datatools-VERSION_NO-release.zip**
14
-
3. Look in the unziped folder and find *dist/macosx-amd64/*
15
-
4. Drag (or copy) *jsoncols*, *jsonrange*, etc. to a "bin" directory in your path
16
-
5. Open and "Terminal" and run `jsoncols -h` to confirm you were successful
42
+
1. Download the zip file
43
+
2. Unzip the zip file
44
+
3. Copy the executables to $HOME/bin (or a folder in your path)
45
+
4. Make sure the new location in in our path
46
+
5. Test
47
+
48
+
Here's an example of the commands run in the Terminal App after downloading the
49
+
zip file.
50
+
51
+
```shell
52
+
cd Downloads/
53
+
unzip datatools-*-macosx-amd64.zip
54
+
mkdir -p $HOME/bin
55
+
cp -v bin/*$HOME/bin/
56
+
export PATH=$HOME/bin:$PATH
57
+
csvfind -version
58
+
```
17
59
18
60
### Windows
19
61
20
-
1. Download **datatools-VERSION_NO-release.zip** from [https://github.com/caltechlibrary/datatools/releases/latest](https://github.com/caltechlibrary/datatools/releases/latest)
21
-
2. Open the file manager find and unzip **datatools-VERSION_NO-release.zip**
22
-
3. Look in the unziped folder and find *dist/windows-amd64/*
23
-
4. Drag (or copy) *jsoncols.exe*, *jsonrange.exe*, etc. to a "bin" directory in your path
24
-
5. Open Bash and and run `jsoncols -h` to confirm you were successful
62
+
1. Download the zip file
63
+
2. Unzip the zip file
64
+
3. Copy the executables to $HOME/bin (or a folder in your path)
65
+
4. Test
66
+
67
+
Here's an example of the commands run in from the Bash shell on Windows 10 after
68
+
downloading the zip file.
69
+
70
+
```shell
71
+
cd Downloads/
72
+
unzip datatools-*-windows-amd64.zip
73
+
mkdir -p $HOME/bin
74
+
cp -v bin/*$HOME/bin/
75
+
export PATH=$HOME/bin:$PATH
76
+
csvfind -version
77
+
```
25
78
26
-
### Linux
27
79
28
-
1. Download **datatools-VERSION_NO-release.zip** from [https://github.com/caltechlibrary/datatools/releases/latest](https://github.com/caltechlibrary/datatools/releases/latest)
29
-
2. Find and unzip **datatools-VERSION_NO-release.zip**
30
-
3. In the unziped directory and find for *dist/linux-amd64/*
31
-
4. Copy *jsoncols*, *jsonrange*, etc. to a "bin" directory (e.g. cp ~/Downloads/datatools-VERSION_NO-release/dist/linux-amd64/\*~/bin/)
32
-
5. From the shell prompt run `jsoncols -h` to confirm you were successful
80
+
### Linux
33
81
34
-
### Raspberry Pi
82
+
1. Download the zip file
83
+
2. Unzip the zip file
84
+
3. Copy the executables to $HOME/bin (or a folder in your path)
85
+
4. Test
35
86
36
-
If you are using a Raspberry Pi 2 or later use the ARM7 VERSION_NO, ARM6 is only for the first generaiton Raspberry Pi.
87
+
Here's an example of the commands run in from the Bash shell after
88
+
downloading the zip file.
37
89
38
-
1. Download **datatools-VERSION_NO-release.zip** from [https://github.com/caltechlibrary/datatools/releases/latest](https://github.com/caltechlibrary/datatools/releases/latest)
39
-
2. Find and unzip **datatools-VERSION_NO-release.zip**
40
-
3. In the unziped directory and find for *dist/raspberrypi-arm7/*
41
-
4. Copy *jsoncols*, *jsonrange*, etc. to a "bin" directory (e.g. cp ~/Downloads/datatools-VERSION_NO-release/dist/raspberrypi-arm7/\*~/bin/)
42
-
+ if you are using an original Raspberry Pi you should copy the ARM6 version instead
43
-
5. From the shell prompt run `jsoncols -h` to confirm you were successful
90
+
```shell
91
+
cd Downloads/
92
+
unzip datatools-*-linux-amd64.zip
93
+
mkdir -p $HOME/bin
94
+
cp -v bin/*$HOME/bin/
95
+
export PATH=$HOME/bin:$PATH
96
+
csvfind -version
97
+
```
44
98
45
99
46
-
##Compiling from source
100
+
### Raspberry Pi
47
101
48
-
If you have go v1.7.4 or better installed then should be able to "go get" to install all the **datatools** utilities and
102
+
Released version is for a Raspberry Pi 2 or later use (i.e. requires ARM 7 support).
49
103
104
+
1. Download the zip file
105
+
2. Unzip the zip file
106
+
3. Copy the executables to $HOME/bin (or a folder in your path)
107
+
4. Test
108
+
109
+
Here's an example of the commands run in from the Bash shell after
110
+
downloading the zip file.
111
+
112
+
```shell
113
+
cd Downloads/
114
+
unzip datatools-*-raspbian-arm7.zip
115
+
mkdir -p $HOME/bin
116
+
cp -v bin/*$HOME/bin/
117
+
export PATH=$HOME/bin:$PATH
118
+
csvfind -version
50
119
```
51
-
go get -u github.com/caltechlibrary/datatools/...
52
-
```
53
120
54
-
Or for Windows 10 Powershell (assumes the Windows versions of Go and Git are previously installed)
55
121
122
+
## Compiling from source
123
+
124
+
_datatools_ is "go gettable". Use the "go get" command to download the dependant packages
0 commit comments