Matterbabble is an API client for Discourse and Matterbridge. It mirrors Discourse posts in a topic to Matterbridge messages on a gateway, and vice versa. It works well with the Discourse Babble plugin, which formats a thread as a chat room.
Installation and Usage
To install, execute:
pip install matterbabble
To run, execute:
python -m matterbabble CONFIGPATH
providing the path to a Matterbabble configuration file as described below.
Configuration
Matterbabble is configured with a configparser INI file.
Example:
[discourse]
address = https://forum.bitphoenixsoftware.com/
username = matterbridge
token = 0dwdmaddzludwvntpg7gss6dxdem7byemre3krw86k60n39vn1ni7wganakpzjd0
fmt = {username}: {message}
[matterbridge]
address = http://127.0.0.1:4242/
token = oTUaGHctYYve28nYNMzLZszJvT1RD3kXLlZwPLULEaTFMRrGyvFzdvOdpsuQYFEhD84qL9PP5FJvGFOsQINESs1keaLO8SnvQNHHM6wq41mwHVX0NNKaBXD5uDaDhZ4p
[connections]
lounge = /babble/topics/68
[logging]
level = INFO
discourse
The discourse section must contain an address and API key for a Discourse forum, and the username of the user you want the client to run as. You can also change the format used for messages going to Discourse (the fmt key is optional).
matterbridge
The matterbridge section must contain the BindAddress of a Matterbridge API instance. If you added a Token to the API, you must also include that here.
connections
The connections section maps Matterbridge gateways to Discourse topics. The ID of a topic is the last component of the URL after you navigate to it on Discourse, and the correct format is /topics/{id}. You can find a Babble chat room’s ID by clicking on it in the admin chat manager. The format for those is /babble/topics/{id}.
logging
The optional logging section can contain basicConfig options for logging in Matterbabble. You can set level to INFO to log raw objects sent through Matterbabble to stderr.
Caveat Emptor
Inline images in the Discourse post are currently replaced with links before being sent to the gateway because they generally aren’t supported by chat rooms. Maybe there will be a better solution to this problem in future.
Copyright
Copyright 2019 Declan Hoare
Licensed under Apache License 2.0. NO WARRANTY
1 maintainer
Metadata
1 maintainer
Release files for matterbabble 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| matterbabble-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Release files / matterbabble-1.0.1-py3-none-any.whl
| Download URL | matterbabble-1.0.1-py3-none-any.whl |
|---|---|
| Size | 11.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
83abbb2d571d0e3e44aaf0d2a67ee5902643c9ffce5f493cb33d6e6649155bca
|
|
BLAKE2b-256 checksum How to use checksums |
5e006da33b172fea65bc8dc834d00651194022b7912fda7b88b101b7656185ca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.2
|
