Description
-----------

OAI-PERL are a set of Perl modules that provide an API to the Open Archives
Initiative Protocol for Metadata Harvesting (OAI-PMH).

OAI-PMH is a XML-over-HTTP protocol for transferring metadata between a
repository (the HTTP server) and service provider (the HTTP client).

Synopsis
--------

	use HTTP::OAI::Harvester;

	my $h = HTTP::OAI::Harvester->new(
		baseURL=>'http://eprints.ecs.soton.ac.uk/perl/oai2',
		debug=>1,
	);

	my $r = $h->ListIdentifiers(
		metadataPrefix=>'oai_dc'
	);
	die unless $r->is_success();

	while(my $rec = $r->next) {
		# Check we didn't fail on a resumption token
		die unless $rec->is_success();
		print $rec->identifier();
	}

Installation
------------

	perl Makefile.pl
	make
	make test
	make install

To disable the network tests use:
export SKIP_HTTP_OAI_NETTESTS=1

Use the following to view the root documentation:

	man HTTP::OAI::Harvester
	man HTTP::OAI::Repository

Utility Scripts
---------------

bin/oai_browser - Interactively browse an OAI repository

Related Modules
---------------

Net::OAI::Harvester by Ed Summers.

Development
-----------

git clone git://github.com/timbrody/perl-oai-lib.git

Author
------

Copyright 2012 © Tim Brody

This module is released under the same terms as Perl.
