The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Museum::EICAS - A simple interface to the EICAS museum API

VERSION

Version 0.01

SYNOPSIS

Provides access to the bulk items, individual item, and media endpoints from the EICAS (European Institute for Contemporary Art and Science.) See https://collectie.eicas.nl/api/items?per_page=10 for an example of how the API looks.

    use Museum::EICAS;

    my $m = Museum::EICAS->new();

    # Returns an arrayref of all the data.
    my $all = $m->get_items();
   
    # Get a particular item
    my $item = $m->get_item(42);

    # Get media data for an item
    my $media = $m->get_media($item);

    # Or for a particular media ID (not item ID)
    my $media = $m->get_media(69);

The data is returned pretty much as it comes from the endpoint, converted into a Perl structure.

Generally calls die on failure.

METHODS

get_items

Returns an arrayref of all the data in the EICAS catalogue. At time of writing, this is small enough that it's no problem.

get_item

Fetches the item detail, the only parameter is the item ID.

get_media

Returns an arrayref containing the media entries associated with the passed in item record. Empty list if there are none.

AUTHOR

Robin Sheat, <rsheat at cpan.org>

BUGS

Please report any bugs or feature requests to bug-museum-eicas at rt.cpan.org, or through the web interface at https://rt.cpan.org/NoAuth/ReportBug.html?Queue=Museum-EICAS. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Museum::EICAS

You can also look for information at:

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

This software is Copyright (c) 2023 by Robin Sheat.

This is free software, licensed under:

  The GNU Affero General Public License, Version 3, November 2007