xbus.broker 0.2.0

Xbus Broker written in Python3

xbus.broker

xbus.broker is the central piece of the Xbus project.

Related projects:

• xbus.file_emitter <https://bitbucket.org/xcg/xbus.file_emitter>

• xbus.monitor <https://bitbucket.org/xcg/xbus.monitor>

• xbus_monitor_js <https://bitbucket.org/xcg/xbus_monitor_js>

• xbus.clearinghouse <https://bitbucket.org/xcg/xbus.clearinghouse>

Xbus

Xbus is an Enterprise service bus. As such it aims to help IT departments achieve a better application infrastructure layout by providing a way to urbanize the IT systems.

The goals of urbanization are:

• high coherence

• low coupling

More information about Xbus:

• Documentation: <http://xbusbroker.readthedocs.org/>

• Website: <https://xbus.io/>

Installing

Get requirements: python3-dev, 0mq, python3 and redis:

$ sudo apt-get install libzmq3-dev python3 python3-dev redis-server virtualenvwrapper

Set up a virtualenv with Python 3:

$ mkvirtualenv -p /usr/bin/python3 xbus

Install the xbus.broker package:

$ pip install xbus.broker

Configuring

Create configuration files (eg for the 0.1.3 version):

$ wget https://bitbucket.org/xcg/xbus.broker/raw/0.1.3/etc/config.ini-example -O config.ini
$ wget https://bitbucket.org/xcg/xbus.broker/raw/0.1.3/etc/logging.ini-example -O logging.ini

Edit the files following comments written inside. Note: Ensure the path to the logging file is an absolute path.

Initialize the database

Run the “setup_xbusbroker” program:

$ setup_xbusbroker -c config.ini

Migrating an existing database

Use the “migrate_xbus_broker” project. Instructions are on <https://bitbucket.org/xcg/migrate_xbus_broker/>.

Running

Run the “start_xbusbroker” program:

$ start_xbusbroker -c config.ini

Contributors

Sorted by commit date:

• Florent Aide, <[e-mail]>

• Jérémie Gavrel, <[e-mail]>

• Houzéfa Abbasbhay, <[e-mail]>

• Alexandre Brun, <[e-mail]>

• Vincent Hatakeyama, <[e-mail]>

• Patrice Journoud, <[e-mail]>

Changelog

0.2.0 (2016-06-27)

• Better message state tracking.

• Undelivered messages are re-sent when the recipient comes back.

• More logging.

• Documentation improvements.

• Upgrade step: Migrate the DB to version 1 using <https://bitbucket.org/xcg/migrate_xbus_broker/>.

0.1.5 (2015-05-25)

• Update requirements.

0.1.4 (2015-05-18)

• Update the setup script wrt permission changes.

• Define required package versions in setup.py and document why some are frozen.

0.1.3 (2015-05-11)

• Improve the README and configuration file paths.

0.1.2 Initial release (2015-05-11)

• Initial implementation of the Xbus broker in Python 3.