INSTALL

irdmtools is an experimental Go package and command line tools for working with institutional repositories (e.g. Invenio RDM). It is distributed in source code and in binary form for macOS (Intel and M1), Linux (Intel and ARM 64), Raspberry Pi OS.

To test the latest version you need the required development environment and follow the steps listed below in “Compiling from Source”.

Quick install using curl

The following experimental installer should get the latest stable release for macOS and Linux (e.g. Debian, Ubuntu, Raspberry Pi OS).

Copy and run the following command in your shell (e.g. Terminal)

curl https://caltechlibrary.github.io/irdmtools/installer.sh | sh

NOTE: Windows 11 support is via Window’s Sub-System for Linux (aka WSL). If you have that available then you can use the installer example above.

Requirements

This may change in the future.

Git to clone the repository from GitHub
Golang 1.20.4 or better
GNU Make
Pandoc 3 or better (to build documentation)
Bash
grep

Compiling from Source

clone the repository
change into the cloned directory
run “make”, “make test” and “make install”

Here’s the steps I take to build and test on my macOS box or Linux box.

git clone git@github.com:caltechlibrary/irdmtools.git
cd irdmtools
make
make test
make install