islandora/crayfish

Collection of Islandora microservices, lovingly known as Crayfish.

Package info

github.com/Islandora/Crayfish

Issues

Type:project

pkg:composer/islandora/crayfish

Statistics

Installs: 599

Dependents: 1

Suggesters: 0

Stars: 10

4.1.0 2025-01-07 16:03 UTC

Requires

None

Requires (Dev)

None

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT a0b33d30db775171722cde7b46c1163c6660c5b9

  • Islandora Foundation <community.woop@islandora.ca>
  • Jonathan Green <Jonathan.Green.woop@lyrasis.org>

README

👁 Minimum PHP Version
👁 Build Status
👁 Contribution Guidelines
👁 LICENSE
👁 codecov

Introduction

A collection of Islandora 8 microservices, lovingly known as Crayfish. Some of the microservices are built specifically for use with a Fedora Repository and API-X, while others are just for general use within Islandora 8.

Requirements

The minimum requirements for any microservice are

Many microservices have extra installation requirements. Please see the README of each microservice for additional details.

Services

Crayfish contains the following services

  • CrayFits: FITS as a microservice.
  • Homarus: FFmpeg as a microservice.
  • Houdini: ImageMagick as a microservice.
  • Hypercube: Tesseract as a microservice.
  • Milliner: Microservice that converts Drupal entities into Fedora resources.
  • Recast: Microservice that remaps Drupal URIs to add Fedora to Fedora links based on associated Drupal URIs in RDF.

See the individual services for more information on their endpoints.

Security

Crayfish microservices use JWTs to handle authentication like the rest of the Islandora 8. It is disabled by default. To enable, set security enabled to true in cfg/cfg.php for any microservice. You can also set the path to an xml configuration file for security a la Syn with the security config parameter.

Development

If you would like to contribute, please get involved by attending our weekly Tech Call. We love to hear from you!

If you would like to contribute code to the project, you need to be covered by an Islandora Foundation Contributor License Agreement or Corporate Contributor License Agreement. Please see the Contributors pages on Islandora.ca for more information.

We recommend using the islandora-playbook to get started. If you want to pull down the submodules for development, don't forget to run git submodule update --init --recursive after cloning.

Maintainers

This project has been sponsored by:

  • American Philosophical Society
  • Born-Digital
  • discoverygarden inc.
  • LYRASIS
  • McMaster University
  • PALS
  • University of Limerick
  • University of Manitoba
  • UPEI
  • Simon Fraser University
  • York University

License

MIT