Caltech Library logo

Installation

orcidtools is a Go package which includes an command line program named orcid for fetching data from the ORCID API. The command line program runs in a shell like Bash. You can find compiled version in the releases.

This is generalized instructions for a release.

Compiled version

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

https://github.com/caltechlibrary/orcidtools/releases/latest

Platform Zip Filename
Windows orcidtools-VERSION_NUMBER-windows-amd64.zip
Mac OS X orcidtools-VERSION_NUMBER-macosx-amd64.zip
Linux/Intel orcidtools-VERSION_NUMBER-linux-amd64.zip
Raspbery Pi orcidtools-VERSION_NUMBER-raspbian-arm7.zip

The basic recipe

Mac OS X

  1. Download the zip file
  2. Unzip the zip file
  3. Copy the executables to $HOME/bin (or a folder in your path)
  4. Make sure the new location in in our path
  5. Test

Here’s an example of the commands run in the Terminal App after downloading the zip file.

    cd Downloads/
    unzip orcidtools-*-macosx-amd64.zip
    mkdir -p $HOME/bin
    cp -v bin/* $HOME/bin/
    export PATH=$HOME/bin:$PATH
    orcid -version

Windows

  1. Download the zip file
  2. Unzip the zip file
  3. Copy the executables to $HOME/bin (or a folder in your path)
  4. Test

Here’s an example of the commands run in from the Bash shell on Windows 10 after downloading the zip file.

    cd Downloads/
    unzip orcidtools-*-windows-amd64.zip
    mkdir -p $HOME/bin
    cp -v bin/* $HOME/bin/
    export PATH=$HOME/bin:$PATH
    orcid -version

Linux

  1. Download the zip file
  2. Unzip the zip file
  3. Copy the executables to $HOME/bin (or a folder in your path)
  4. Test

Here’s an example of the commands run in from the Bash shell after downloading the zip file.

    cd Downloads/
    unzip orcidtools-*-linux-amd64.zip
    mkdir -p $HOME/bin
    cp -v bin/* $HOME/bin/
    export PATH=$HOME/bin:$PATH
    orcid -version

Raspberry Pi

Released version is for a Raspberry Pi 2 or later use (i.e. requires ARM 7 support).

  1. Download the zip file
  2. Unzip the zip file
  3. Copy the executables to $HOME/bin (or a folder in your path)
  4. Test

Here’s an example of the commands run in from the Bash shell after downloading the zip file.

    cd Downloads/
    unzip orcidtools-*-raspbian-arm7.zip
    mkdir -p $HOME/bin
    cp -v bin/* $HOME/bin/
    export PATH=$HOME/bin:$PATH
    orcid -version

Compiling from source

orcidtools is “go gettable”. Use the “go get” command to download the dependant packages as well as orcidtools’s source code.

    go get -u github.com/caltechlibrary/orcidtools/...

Or clone the repstory and then compile

    cd
    git clone https://github.com/caltechlibrary/orcidtools src/github.com/caltechlibrary/orcidtools
    cd src/github.com/caltechlibrary/orcidtools
    make
    make test
    make install