Description

PyFedoREST is a pure Python package for creating and managing objects in a Fedora Repository. It is a minimal Python wrapper around V3.2.1 of the Fedora REST API.

The source code for this product is also available from the Fedora Commons SVN at https://fedora-commons.svn.sourceforge.net/svnroot/fedora-commons/incubator/kepler/trunk/python/PyFedoREST. The package is available in both zip and tar/gzip formats as well as eggs for Python 2.4, Python 2.5 or Python 2.6.

In order to use this package, you must install the httplib2 package in your Python path. httplib2 is available from PYPI or Google.

PyFedoREST was written by Rick Moore for Fedora Commons and the Cornell University Library. Funding for this project was provided under a grant from the Mellon Foundation.

Product components

FCRepoRestAPI class

Usage :

from fcrepo.http.restapi import FCRepoRestAPI

rest = FCRepoRestAPI(repository_url='http://localhost:8080/fedora', username='fedoraAdmin',
 password='fedora', realm='any', namespace='fedora')

This pure Python class contains a one-to-one implementation of each method documented in Version 3.2.1 of the Fedora Repository REST API. It is the only class you need import into your application.

• All methods are named as documented on the Fedora REST API wiki page.
• Required arguments are expected in the order listed in the documentation.
• Optional arguments are acquired using Python's builtin argument dictionary syntax where each optional argument is passed as a name=value pair.
  • EXCEPTION : for the ingest() method, pid is defaulted to 'new' in the Python implementation.
• Methods documented as "Not implemented" exist in the code but return a Python NotImplementedError exception.
• All REST API methods return an instance of the FCRepoResponse class described below.

FCRepoRequestFactory class

Usage:

from fcrepo.http.RequestFactory import FCRepoRequestFactory

factory = FCRepoRequestFactory(repository_url='http://localhost:8080/fedora', username='fedoraAdmin',
 password='fedora', realm='any')

This is a support class that supplies HTTP connections and services to instances of FCRepoRestAPI. It implements GET, PUT, POST and DELETE methods in a very simple Jython wrapper around the same org.apache.commons.httpclient Java libraries used in the standard Fedora installation. The GET, PUT, POST and DELETE methods (and, thus, the FCRepoRestAPI class methods that use them) each return an instance of the FCRepoResponse class.

FCRepoResponse class

This is a support class that provides a Pythonic interface to elements of a response to an httplib2 request. It is returned by the HTTP methods of a FCRepoRequestFactory and implements the following methods:

• getBody()
  • Returns the body content returned by the request.
  • DOES NOT support streamed content yet.
• getFooter(name, default=None)
  • Returns the value of the request footer specified in name.
  • If the footer does not exist, the value specified in default is returned.
• getFooters()
  • Returns all footers from the request as a Python dictionary.
• getHeader(name, default=None)
  • Returns the value of the request header specified in name.
  • If the header does not exist, the value specified in default is returned.
• getHeaders()
  • Returns all headers from the request as a Python dictionary.
• getStatus()
  • Returns the status code returned by the request.
• getRequestMethod()
  • Returns the name of the HTTP method in the request.
  • One of GET, PUT, POST or DELETE.
• getRequestURI()
  • Returns the URI representation of the request.
• getRepository()
  • Returns the base URL of the Fedora Repository.