Sickle 0.5

A lightweight OAI client library for Python

Sickle: OAI-PMH for Humans

Sickle is a lightweight OAI-PMH client library written in Python. It has been designed for conveniently retrieving data from OAI interfaces the Pythonic way:

>>> from sickle import Sickle
>>> sickle = Sickle('http://elis.da.ulcc.ac.uk/cgi/oai2')
>>> records = sickle.ListRecords(metadataPrefix='oai_dc')
>>> records.next()
<Record oai:eprints.rclis.org:4088>

Features

• Easy harvesting of OAI-compliant interfaces

• Support for all six OAI verbs

• Convenient object representations of OAI items (records, headers, sets, …)

• Automatic de-serialization of Dublin Core-encoded metadata payloads to Python dictionaries

• Option for ignoring deleted items

Installation

pip install sickle

Dependencies:

• requests

• lxml

Documentation

Documentation is available at Read the Docs

Development

• Sickle @ GitHub

Changelog

Version 0.5

Novemver 12, 2015

• support for Python 3

• consider resumption tokens with empty tag bodies

Version 0.4

May 31, 2015

• bug fix: resumptionToken parameter is exclusive

• added support for harvesting complete OAI-XML responses

Version 0.3

April 17, 2013

• added support for protected OAI interfaces (basic authentication)

• made class mapping for OAI elements configurable

• added options for HTTP timeout and max retries

• added handling of HTTP 503 responses

Version 0.2

February 26, 2013

• OAI items are now represented as their own classes instead of XML elements

• library raises OAI-specific exceptions

• made lxml a required dependency

Version 0.1

February 20, 2013

First public release.