{"id":24326936,"url":"https://github.com/ivoire/reactobus","last_synced_at":"2025-07-19T23:36:09.087Z","repository":{"id":57460373,"uuid":"48810081","full_name":"ivoire/ReactOBus","owner":"ivoire","description":"https://git.lavasoftware.org/ReactOBus/ReactOBus","archived":false,"fork":false,"pushed_at":"2019-08-06T08:55:13.000Z","size":186,"stargazers_count":4,"open_issues_count":7,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-23T00:49:13.676Z","etag":null,"topics":["message-broker","zmq"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ivoire.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-12-30T16:44:04.000Z","updated_at":"2019-08-06T08:55:17.000Z","dependencies_parsed_at":"2022-08-28T13:53:17.025Z","dependency_job_id":null,"html_url":"https://github.com/ivoire/ReactOBus","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/ivoire/ReactOBus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivoire%2FReactOBus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivoire%2FReactOBus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivoire%2FReactOBus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivoire%2FReactOBus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ivoire","download_url":"https://codeload.github.com/ivoire/ReactOBus/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivoire%2FReactOBus/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266042003,"owners_count":23867960,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["message-broker","zmq"],"created_at":"2025-01-17T21:27:22.148Z","updated_at":"2025-07-19T23:36:09.068Z","avatar_url":"https://github.com/ivoire.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"ReactOBus\n=========\n\nReactOBus is a message broker that helps to create software bus over the network\nand to react to some messages.\n\n\nFeatures\n========\n\nReactOBus is able to:\n\n* collect events (as network messages) from different sources\n* publish the stream of events\n* store the events in a database\n* launch specific commands when an event match some conditions\n\n\nIn a near future, ReactOBus will be able to:\n\n* filter-out some events\n* modify on-the-fly event format\n* ...\n\n\nUsing ReactOBus\n===============\n\nRequirements\n------------\n\nReactOBus is known to work with Python3.4 and Python3.5 under Linux.\n\nIt depends on (see **requirements.txt**):\n\n* pyzmq\n* pyYAML\n* SQLAlchemy (if you wish to store events in a database)\n* setproctitle\n\n\nInstalling\n----------\n\nReactOBus is available on [pypi](https://pypi.python.org/pypi/ReactOBus) and\ncan be installed with:\n\n    pip install ReactOBus\n\nBy default, **pip** will not install SQLAlchemy. If need, install it manually\nafterward or ask pip to include the right ReactOBus variant with:\n\n    pip install ReactOBus[db]\n\nIt's also possible to execute ReactOBus directly from the sources:\n\n    git clone https://git.lavasoftware.org/ReactOBus/ReactOBus\n    cd ReactOBus\n    virtualenv -p python3 venv\n    source venv/bin/activate\n    pip install -r requirements.txt\n    python reactobus --level DEBUG --conf share/examples/reactobus.yaml\n\n\nConfiguration\n-------------\n\nThe configuration file is a YAML dictionary with:\n\n* *inputs*: a list of input streams\n* *outputs*: a list of output streams\n* *core*: configuration of the internal sockets\n* *reactor*: the reacting part of ReactOBus\n* *db*: the database configuration\n\nAll keys except *core* and *inputs* are optional. If the optional keys are not\nfound in the configuration, the corresponding modules won't be loaded.\n\n\nMessage format\n--------------\n\nFor the moment, ReactOBus only accepts one type of messages. The messages\nshould be multipart ZMQ messages with the following meaning:\n\n* **topic**\n* **uuid** (as generated by uuid.uuid1() in Python)\n* **datetime** when the message was generated (isoformat)\n* **username** of the sending process or user\n* **data** as JSON\n\n\nTesting ReactOBus\n=================\n\nIn order to run ReactOBus automatic tests, you will have to install *py.test*:\n\n    pip install pytest\n\nThen run the tests using:\n\n    py.test tests -v\n    [...]\n    tests/test_core.py::test_core PASSED\n    tests/test_db.py::test_run PASSED\n    tests/test_db.py::test_errors PASSED\n    [...]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivoire%2Freactobus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fivoire%2Freactobus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivoire%2Freactobus/lists"}