edeposit.amqp.ltp 1.0.4
E-Deposit's AMQP binding to Long Time Preservation system.
License: MIT

Introduction
============

.. image:: https://badge.fury.io/py/edeposit.amqp.ltp.png
    :target: https://pypi.python.org/pypi/edeposit.amqp.ltp

.. image:: https://img.shields.io/pypi/dm/edeposit.amqp.ltp.svg
    :target: https://pypi.python.org/pypi/edeposit.amqp.ltp

.. image:: https://readthedocs.org/projects/edeposit-amqp-ltp/badge/?version=latest
    :target: http://edeposit-amqp-ltp.readthedocs.org/

.. image:: https://img.shields.io/pypi/l/edeposit.amqp.ltp.svg

.. image:: https://img.shields.io/github/issues/edeposit/edeposit.amqp.ltp.svg
    :target: https://github.com/edeposit/edeposit.amqp.ltp/issues


This project provides bindings to LTP (Long Time Preservation) system, which
archives ebooks.

Documentation
-------------

Full module documentation and description can be found at Read the Docs:

- http://edeposit-amqp-ltp.readthedocs.org/

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

Prepare system ::

   edeposit-aplikace:~ # groupadd edep
   edeposit-aplikace:~ # useradd ltp

- add user ``ltp`` and ``edeposit`` into group ``edep``

- install package::

   edeposit-aplikace:~ # pip install -U edeposit.amqp                                                              
   
- create necessary directories::

   edeposit-aplikace:~ # mkdir /home/ltp
   edeposit-aplikace:~ # chown ltp:edep /home/ltp/ -R
   
   edeposit-aplikace:~ # sudo su - ltp
   ltp@edeposit-aplikace:~> mkdir edep2ltp
   ltp@edeposit-aplikace:~> mkdir ltp2edep

- add them proper permissions::

   ltp@edeposit-aplikace:~> chgrp edep edep2ltp/
   ltp@edeposit-aplikace:~> chgrp edep ltp2edep/
   ltp@edeposit-aplikace:~> chmod 770 edep2ltp/ ltp2edep/

   ltp@edeposit-aplikace:~> ls -al
   total 16
   drwxr-xr-x 4 ltp  edep 4096 Jul 24 15:48 .
   drwxr-xr-x 6 root root 4096 Jul 24 15:40 ..
   drwxrwx--- 2 ltp  edep 4096 Jul 24 15:48 edep2ltp
   drwxrwx--- 2 ltp  edep 4096 Jul 24 15:48 ltp2edep


- authorize external ssh user by its public key::

   ltp@edeposit-aplikace:~> mkdir .ssh
   ltp@edeposit-aplikace:~> cat public-key.pub >> .ssh/authorized_keys

   ltp@edeposit-aplikace:~> ls -al .ssh/
   total 12
   drwxr-xr-x 2 ltp users 4096 Jul 24 16:13 .
   drwxr-xr-x 5 ltp edep  4096 Jul 24 16:05 ..
   -rw-r--r-- 1 ltp users  603 Jul 24 16:13 authorized_keys

Run application
----------------

Run it as ``ltp`` user::

   ltp@edeposit-aplikace:~> edeposit_amqp_ltpd.py start --foreground


Contributors
============

- Bystroushaak <bystrousak@kitakitsune.org>, Developer

Changelog
=========

1.0.4
-----
    - Added ``complete_`` prefix to export directory.

1.0.3
-----
    - Temporarily disabled features and tests allowed again.

1.0.2
-----
    - Bugfixes based on feedback.
    - Temporary disabled some of tests and functionality (UUID in info name, checksums), because LTP subsystem is broken on their side.

1.0.1
-----
    - Bugfix of MANIFEST.in.

1.0.0
-----
    - URN:NBN incorporated into info file.
    - Some refactorings.
    - This version should successfully export package into to output directory and also trace the state changes.

0.11.0 - 0.11.3
----------------
    - Rewritten info_composer.
    - Rests fixed and significantly improved.
    - Added tracking feature to AMQP connector.
    - Fixed bug in packaging system.
    - Fixed bug in import system.
    - Attempt to fix the directory copying problem.

0.10.0
------
    - Fixed a lot of bugs.
    - Applied feedback from the LTP team.
    - Code for the MODS transformation moved into own module https://github.com/edeposit/marcxml2mods

0.9.0 - 0.9.2
-------------
    - Alpha version released for my colleague, which needs to use xslt_transformer.py.
    - Alpha 2. Fixed few bugs, added documentation.
    - Fixed some bugs, comments. Added more postprocessing.
    - Fixed bugs by the comments from mr. Bouchner.
    - Added content of the README.
    - ``reactToAMQPMessage()`` parameters modified.

0.1.0
-----
    - Project created.