Xbus Stdlib
===========

Xbus Stdlib is a Xbus client that provides a library of actor implentations,
and a few shared utilities.

Actors
------

- file-gateway actors: use a local or remote filesystem as a gateway to/from
  xbus messages. See filegateway/README.rst
- xbus2xbus: provides a consumer that forwards envelopes to another xbus
  instance. See xbus2xbus/README.rst

Utilities
---------

FileMessageReader
'''''''''''''''''

A helper to read messages that respect the
[File Message Format](https://project.orus.io/project/xbus-rd/wiki/file-message-format).

FileLocationS3
''''''''''''''

Provides support for "s3" location of file messages.

To work properly, access and secret keys must be provided in the client
configuration file for each potential provider endpoint.

For example:

.. code-block:: yaml

    account-name: accountname
    actors:
      # ...
    file-location:
      s3:
         "myminio:9002":
           access-key: myaccesskey
           secret-key: mysecretkey
           ssl: true


FileLocationHTTP
''''''''''''''''

Provides support for "http" location of file messages.