xenofem/python-zulip-api
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
python-zulip-api/zulip/integrations/bridge_between_zulips
History
PIG208 6f3f9bf7e4 black: Reformat without skipping string normalization.
2021-06-02 18:45:57 -07:00
..
interrealm_bridge_config.py black: Reformat skipping string normalization. 2021-06-02 18:45:57 -07:00
README.md bridge_between_zulips: Replace "subject" with "topic" in doc. 2020-04-07 16:20:19 -07:00
run-interrealm-bridge black: Reformat without skipping string normalization. 2021-06-02 18:45:57 -07:00

README.md

Inter-realm bot

Let realm_1 be the first realm, realm_2 be the second realm. Let bot_1 be the relay bot in realm_1, bot_2 be the relay bot in realm_2.

This bot relays each message received at a specified topic in a specified stream from realm_1 to a specified topic in a specified stream in realm_2.

Steps to create an inter-realm bridge:

  1. Register a generic bot (bot_1) in realm_1
  2. Enter the api info of bot_1 into the config file (interrealm_bridge_config.py)
  3. Create a stream in realm_1 (stream_1) and a topic for the bridge
  4. Make sure bot_1 is subscribed to stream_1
  5. Enter the stream and the topic into the config file.
  6. Do step 1-5 but for bot_2 and with all occurrences of _1 replaced with _2
  7. Run the script run-interrealm-bridge

If the --stream flag is added (i.e. run-interrealm-bridge --stream), then the mirroring granularity becomes stream-wide. Instead of one topic, all topics within the stream are mirrored as-is without translation.