alma-go

CLI and Go client for the Ex Libris Alma api

Configuration

Configuration is through environment variables:

export ALMA_URL="https://api-eu.hosted.exlibrisgroup.com/almaws/v1"
export ALMA_API_KEY="****"

Using the CLI

alma user 1234 > /tmp/user-record.json
cat /tmp/user-record.json | alma user update 1234

alma bibs --mms-id 991119460000541,991457160000541

alma bib 991457160000541
alma bib holdings 991457160000541
alma bib holding 991022800000541 228340160000521
alma bib holding items 991022800000541 228340160000521

alma requested-resources --circ-desk DEFAULT_CIRC_DESK --library MAIN

alma library MAIN
alma library open-hours MAIN

alma open-hours --scope MAIN > /tmp/open-hours.json
alma open-hours update --scope MAIN < /tmp/open-hours.json

alma printouts

Using the Go library

import 	"github.com/ugent-library/alma-go"

almaClient := alma.New(alma.Config{
	URL:    "",
	ApiKey: "",
})

user, err := almaClient.GetUser(ctx, "1234")

Running via Docker

docker pull ugent-library/alma-client:latest
docker run ugent-library/alma-client user 1234

Building from source

git clone [email protected]:ugent-library/alma-go.git
cd alma-go
go build -o ~/bin/alma cmd/alma/*

Development

go run cmd/alma/* [command] [opts...]

See the REST API documentation for more information.