messaging.rst 1.2 KB

123456789101112131415161718192021222324252627282930
  1. LAKEsuperior Messaging
  2. ======================
  3. LAKEsuperior implements a messaging system based on ActivityStreams, as
  4. indicated by the `Feodra API
  5. specs <https://fedora.info/2017/06/30/spec/#notifications>`__. The
  6. metadata set provided is currently quite minimal but can be easily
  7. enriched by extending the `default formatter
  8. class <https://github.com/scossu/lakesuperior/blob/master/lakesuperior/messaging/messenger.py>`__.
  9. STOMP is the only supported protocol at the moment. More protocols may
  10. be made available at a later time.
  11. LAKEsuperior can send messages to any number of destinations: see
  12. `configuration <https://github.com/scossu/lakesuperior/blob/master/etc.defaults/application.yml#L79>`__.
  13. By default, CoilMQ is provided for testing purposes and listens to
  14. ``localhost:61613``. The default route sends messages to
  15. ``/topic/fcrepo``.
  16. A small command-line utility, also provided with the Python
  17. dependencies, allows to watch incoming messages. To monitor messages,
  18. enter the following *after activating your virtualenv*:
  19. ::
  20. stomp -H localhost -P 61613 -L /topic/fcrepo
  21. See the `stomp.py library reference
  22. page <https://github.com/jasonrbriggs/stomp.py/wiki/Command-Line-Access>`__
  23. for details.