skip to navigation
skip to content

edeposit.amqp.aleph 1.5.2

E-Deposit AMQP module providing communication with Aleph

Latest Version: 1.9.5


This package provides an AMQP middle-ware for communication with Aleph. Aleph is a system used in libraries to store meta-data about books and authors.

Full module documentation is hosted at the ReadTheDocs.


Module is hosted at PYPI, and can be easily installed using PIP:

pip install edeposit.amqp.aleph

Source codes can be found at GitHub:


Module provides several submodules:


Data structures for (generic, not just AMQP) communication. It contains reaction function reactToAMQPMessage(), which detects what (serialized) structure was given to her, do some low-level interactions with Aleph and returns result structures.

Module provides also serialize/deserialze functions for generic python namedtuple structures.


Used for raw communication with Aleph server. Communication is read-only and uses special API provided by Aleph X-Services module.

Can be queried using reactToAMQPMessage() defined in __init__.


MARC XML (de)serialization class, which provides some higher-level bindings to MARC records.


Convertor from MARC XML records to Epublication structures defined in __init__.


ISBN checksum validator.

Can be queried using reactToAMQPMessage() defined in __init__.

Acceptance tests

Robot Framework is used to test the sources, which are stored in src/edeposit/amqp/aleph/tests directory.

You can run them manually (from the root of the package):

$ pybot -W 80 --pythonpath src/edeposit/amqp/aleph/tests/:src src/edeposit/amqp/aleph/tests/

Or continuously using nosier:

$ nosier -p src -b 'export' "pybot -W 80 --pythonpath src/edeposit/amqp/aleph/tests/ --pythonpath src src/edeposit/amqp/aleph/tests/"

Command to run the test is wrapped in in the root of the project.

Status of acceptance tests

You can see the results of the tests here:

Results are currently (12.03.2014) outdated, but some form of continuous integration framework will be used in the future.




  • Added tracking of export progress.


  • Added new Query class - DocumentQuery.
  • Documentation cleaned.
  • Added documentation for convertor.
  • Fixed bug in unittests.


  • Queries to test base are now handled by OAI API, which has access.
  • Export is working.


  • Fixed bug in export script.
  • Changelog made more compact.

1.4.5 - 1.4.8

  • Fixed bug #23 in _removeSpecialCharacters().
  • Fixed export bugs (see #21 and #22).
  • Fixed reported bugs in export script.
  • Fixed bug in ISBN submodule.
  • Added unicode support to


  • Documentation of the whole package updated.
  • Fixed bugs in MARC XML parser and Aleph lowlevel API.
  • Added
  • Added TitleQuery.

1.4.1 - 1.4.3

  • Documentation of updated.
  • Assertions in are now annotated (useful for debugging).
  • Version of package and documentation is now automatically parsed from this file.


  • API change in reactToAMQPmessage(), which now takes just two parameters and returns values, instead of calling callbacks.
  • Documentation updated and made useful.


  • Serializers removed from (De)serialization will be handled in edeposit.amqp, because other packages also uses it.

1.2.0 - 1.2.5

  • Fixed bug with package installation, when the package couldn’t find README.rst.
  • User defined JSON configuration is now supported.
  • Documentation is now even for’s attributes.
  • Documentation is now generated automatically everytime the package is generated.
  • Tests and HTML help is now included in PYPI package.
  • All source files are now documented with google style docstrings.
  • Added experimental export support.


  • Project released at PYPI.

1.0 (unreleased)

  • Communication with Aleph is now working.

0.1-dev (unreleased)

  • Package created using templer.
File Type Py Version Uploaded on Size
edeposit.amqp.aleph-1.5.2.tar.gz (md5) Source 2014-06-25 390KB