Metadata-Version: 2.0
Name: xbus.monitor
Version: 0.2.1
Summary: Web app to configure and monitor Xbus
Home-page: http://xbus.io
Author: XCG
Author-email: contact@xcg-consulting.fr
License: UNKNOWN
Keywords: xbus monitor web pyramid
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Framework :: Pyramid
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Other Audience
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
Requires-Dist: aiopg (==0.5.1)
Requires-Dist: msgpack-python (==0.4.3)
Requires-Dist: psycopg2 (==2.5.4)
Requires-Dist: pyramid
Requires-Dist: pyramid-chameleon
Requires-Dist: pyramid-debugtoolbar
Requires-Dist: pyramid-httpauth
Requires-Dist: pyramid-redis-sessions
Requires-Dist: pyramid-tm
Requires-Dist: pyzmq (==14.4.1)
Requires-Dist: redis (>2.9.1)
Requires-Dist: six
Requires-Dist: SQLAlchemy (==0.9.8)
Requires-Dist: transaction
Requires-Dist: waitress
Requires-Dist: xbus.broker (>=0.2.0)
Requires-Dist: xbus.file-emitter
Requires-Dist: zope.sqlalchemy (==0.7.5)

xbus.monitor
============

This package provides tools to monitor and administer Xbus <http://xbus.io>.

The monitor serves a REST API; it also includes a backbone.js client app:

- xbus_monitor_js <https://bitbucket.org/xcg/xbus_monitor_js>: Single-page
  JavaScript Backbone application that communicates with xbus.monitor via its
  REST API.


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: <http://xbus.io/>
  - Presentation: <http://bit.ly/1AYtQa6>


Installing
----------

Set up a virtualenv::

    $ mkvirtualenv -p /usr/bin/python3 xbus

Install the xbus.monitor package::

    $ pip install xbus.monitor


Configuring
-----------

Follow the xbus.broker README file to set it up.

Xbus monitor settings are within the etc/production-example.ini file; grab it
from bitbucket (eg for the 0.1.2 version)::

    $ wget https://bitbucket.org/xcg/xbus.monitor/raw/0.1.2/etc/production-example.ini -O monitor.ini

Edit the file following comments written inside.

Localization:

    Edit the "pyramid.default_locale_name" variable. Note: Only "en_US" and
    "fr_FR" are supported for now.


Running
-------

Run as a regular Pyramid program::

  $ pserve monitor.ini


Run tests
---------

::

    nosetests

Development
-----------

When running the monitor for development purposes, it is recommended to deactivate the ``cookie.secure`` option in the configuration file::

    cookie.secure = false

Generate the translation template
---------------------------------

::

    pip install Babel lingua
    python setup.py extract_messages


Other translation tasks
-----------------------

See <http://docs.pylonsproject.org/projects/pyramid/en/latest/narr/i18n.html>.
::

    python setup.py [init_catalog -l en_US] [update_catalog] [compile_catalog]


Thanks
------

xbus.monitor uses the following external projects; thanks a lot to their respective authors:

    - pyramid <http://docs.pylonsproject.org/projects/pyramid/en/latest/>
    - pyramid_httpauth <https://github.com/tarzanjw/pyramid_httpauth>

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

Sorted by commit date:

  - Jérémie Gavrel, <jeremie.gavrel@xcg-consulting.fr>
  - Florent Aide, <florent.aide@xcg-consulting.fr>
  - Houzéfa Abbasbhay, <houzefa.abba@xcg-consulting.fr>
  - Alexandre Brun, <alexandre.brun@xcg-consulting.fr>
  - Brendan Masson, <brendan.masson@xcg-consulting.fr>

Changelog
=========


0.2.1 (2016-07-04)
------------------

  - Fix inclusion of the monitor_js client-side app into the package.


0.2.0 (2016-06-27)
------------------

  - Add new consumer event type settings (related to optional data lookup" /
    clearing features).

  - Resolve aiozmq endpoints beforehand.

  - Safer consumer getter.

  - Log Xbus requests by default in the example configuration file.

  - Simplified deployment; this application now includes a default client.

  - Reworked the login system to apply on the whole client app instead of
    triggering on specific JS requests.

  - Adapt to message tracking changes done in xbus.broker.


0.1.4 (2015-05-25)
------------------

  - Event types: Allow setting the "immediate reply" flag.

  - Update requirements.


0.1.3 (2015-05-18)
------------------

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


0.1.2 Initial release (2015-05-12)
----------------------------------

  - Initial implementation of the Xbus monitor.


