diff options
Diffstat (limited to 'README.MD')
| -rw-r--r-- | README.MD | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/README.MD b/README.MD new file mode 100644 index 0000000..0642003 --- /dev/null +++ b/README.MD @@ -0,0 +1,42 @@ +## XMPP Retired MUC Bot +The repository houses a simple bot build to redirect joining user of MUC room A to room b. + +### requirements +The easiest way to setup a clean Python project environment is to use a virtual environment inside the cloned +repository directory. The following bash lines install the `python-virtualenv` module, create the virtual environment +using Python3 and finally install all dependencies listed in the requirements file. + +```bash +# Debian +apt install python-virtualenv + +# Arch +pacman -S python-virtualenv + +# create a venv folder inside the cloned repository +mkdir venv +virtualenv -p python3 venv/ + +source ./venv/bin/activate +pip install -r requirements.txt +``` + +### configuration +The configuration effort is quite low and should be for the most part be self-explanatory. +The message section features the message templates the bot will use to reply to message / group messages. To further +customize the user experience some variables are available, to for example directly tag the user. + +The room section lists the room a / b the bot connects, redirects to. +The key is the room the bot tries to join and the value is the redirect target. + +### pre-commit framework +This project utilizes the [pre-commit](https://pre-commit.com/) framework to automate various small hick-ups that tend +to happen prior to committing. + +To use the framework it is necessary to follow these steps: +```bash +# install the pre-commit hook +pre-commit install + +# to test your staged files manually run +pre-commit run |