Skip to content
This repository has been archived by the owner on Apr 27, 2022. It is now read-only.
/ foederati Public archive

A library for Ruby to support federated search of Europeana, DPLA, Trove and DigitalNZ

License

Notifications You must be signed in to change notification settings

europeana/foederati

Repository files navigation

Foederati

Build Status Coverage Status security Code Climate

Foederati:

A Ruby library to search Europeana, the Digital Library of America (DPLA), the Digital Library of Australia - Trove, and the Digital Library of New Zealand - DigitalNZ. The library has been designed to make it easy to add more sources to search within.

Usage

With Rails

Configure Foederati in an initializer

# config/initializers/foederati.rb
Foederati.configure do
  api_keys.dpla = 'dpla_api_key'
  api_keys.digitalnz = 'digitalnz_api_key'
  api_keys.europeana = 'europeana_api_key'
  api_keys.trove = 'trove_api_key'

  defaults.limit = 4
end

Mount the engine

# config/routes.rb
mount Foederati::Engine

Search

The Rails engine provides a single controller which searches one or more of the available providers' JSON APIs and returns normalised and simplified search results.

Routes:

Parameters:

  • l: number of results to request from each provider
  • p: comma-separated list of the providers to search
  • q: search query, passed as-is to provider APIs (so keep it simple if searching more than one!)

Without Rails

TODO: instruct how to use Foederati outside of Rails.

Registering custom providers

TODO: instruct how to register custom providers.

Installation

Add this line to your application's Gemfile:

gem 'foederati'

And then execute:

$ bundle

Or install it yourself as:

$ gem install foederati

Contributing

TODO: Contribution directions go here.

License

Licensed under the EUPL v.1.2.

For full details, see LICENSE.md.

About

A library for Ruby to support federated search of Europeana, DPLA, Trove and DigitalNZ

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages