---
name: "Catmandu::Store::OAI"
section: "3pm"
platform: "linux"
package: "libcatmandu-oai-perl"
version: "0.21-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Catmandu::Store::OAI"
---

# Catmandu::Store::OAI(3pm)

A Catmandu store backed by OAI-PMH

## NAME

Catmandu::Store::OAI - A Catmandu store backed by OAI-PMH

## SYNOPSIS

```
    # From the command line
    # Export data from OAI
    $ catmandu export OAI --url http://somewhere.org/oai to JSON > data.json
    # Export only one record
    $ catmandu export OAI --url http://somewhere.org/oai --id 1234
    # Export from a set
    $ catmandu export OAI --url http://somewhere.org/oai --bag fulltext
    # From Perl
    use Catmandu;
    my $store = Catmandu->store('OAI', url => ' http://somewhere.org/oai ');
    # All bags are iterators
    $store->bag->each(sub { ... });
    $store->bag->take(10)->each(sub { ... });
    my $rec = $store->bag->get('1234');
```

## METHODS

### new(url =\> $url , metadataPrefix =\> $metadataPrefix , handler =\> $handler)

Create a new Catmandu::Store::OAI store connected to baseURL `$url`.

## INHERITED METHODS

This Catmandu::Store implements:

- Catmandu::Store

  Each Catmandu::Bag in this Catmandu::Store implements:

- Catmandu::Bag

  ## SEE ALSO

Catmandu::Store , Catmandu::Importer::OAI

## AUTHOR

Patrick Hochstenbach, `"patrick.hochstenbach at ugent.be"`

## LICENSE AND COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.