The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Catmandu::Importer::SRU - Package that imports SRU data

SYNOPSIS

  use Catmandu::Importer::SRU;

  my %attrs = (
    base => 'http://www.unicat.be/sru',
    query => '(isbn=0855275103 or isbn=3110035170 or isbn=9010017362 or isbn=9014026188)',
    recordSchema => 'marcxml',
    parser => 'marcxml'
  );

  my $importer = Catmandu::Importer::SRU->new(%attrs);

  my $count = $importer->each(sub {
        my $schema   = $record->{recordSchema};
        my $packing  = $record->{recordPacking};
        my $position = $record->{recordPosition};
        my $data     = $record->{recordData};
    # ...
  });

  # Using Catmandu::Importer::SRU::Package::marcxml, included in this release

  my $importer = Catmandu::Importer::SRU->new(
    base => 'http://www.unicat.be/sru',
    query => '(isbn=0855275103 or isbn=3110035170 or isbn=9010017362 or isbn=9014026188)',
    recordSchema => 'marcxml' ,
    parser => 'marcxml' ,
  );

  # Using a homemade parser

  my $importer = Catmandu::Importer::SRU->new(
    base => 'http://www.unicat.be/sru',
    query => '(isbn=0855275103 or isbn=3110035170 or isbn=9010017362 or isbn=9014026188)',
    recordSchema => 'marcxml' ,
    parser => MyParser->new , # or parser => '+MyParser'
  );

DESCRIPTION

This Catmandu::Importer imports records via SRU.

SRU diagnostics are emitted as warnings except for parser set to meta.

CONFIGURATION

base

Base URL of the SRU server (required)

query

CQL query (required)

limit

Number of records to fetch in one batch, set to 10 by default. This is translated to SRU request parameter maximumRecords.

Records are fetched in multiple batches of this size or less.

total

Total number of records this importer may return.

Not set by default

recordSchema

Set to dc by default

sortkeys

Optional sorting

operation

Set to searchRetrieve by default

version

Set to 1.1 by default

userAgent

HTTP user agent, set to Mozilla/5.0 by default.

http_client

Instance of HTTP::Tiny or compatible class to fetch URLs with.

parser

Controls how records are parsed before importing. The following options are possible:

  • Instance of a Perl package that implements a parse subroutine. See the default value Catmandu::Importer::SRU::Parser for an example.

  • Name of a Perl package that implements a parse subroutine. The name must be prepended by + or it prefixed with Catmandu::Importer::SRU::Parser::. For instance marcxml will create a Catmandu::Importer::SRU::Parser::marcxml.

  • Function reference that gets passed the unparsed record.

METHODS

All methods of Catmandu::Importer and by this Catmandu::Iterable are inherited. In addition the following methods are provided:

url

Return the current SRU request URL (useful for debugging).

SEE ALSO

Catmandu::Importer, Catmandu::Iterable, http://www.loc.gov/standards/sru/