Simple-Matrix-Bot-Lib
(Version 2.12.3)
Simple-Matrix-Bot-Lib is a Python bot library for the Matrix ecosystem built on matrix-nio.
View on Codeberg or View on PyPi or View docs on readthedocs.io
Learn how you can contribute here.
Features
- hands-off approach: get started with just 10 lines of code (see example)
- end-to-end encryption support
- limited verification support (device only)
- easily extensible config file
- user access management
- access the matrix-nio library to use advanced features
Installation
simplematrixbotlib can be either installed from PyPi or downloaded from Codeberg.
Installation from PyPi:
python -m pip install simplematrixbotlib
Read the docs to learn how to install E2E encryption support.
Download from Codeberg:
git clone --branch master https://codeberg.org/imbev/simplematrixbotlib.git
Example Usage
# echo.py
# Example:
# randomuser - "!echo example string"
# echo_bot - "example string"
import simplematrixbotlib as botlib
creds = botlib.Creds("https://home.server", "echo_bot", "pass")
bot = botlib.Bot(creds)
PREFIX = '!'
@bot.listener.on_message_event
async def echo(room, message):
match = botlib.MessageMatch(room, message, bot, PREFIX)
if match.is_not_from_this_bot() and match.prefix() and match.command("echo"):
await bot.api.send_text_message(
room.room_id, " ".join(arg for arg in match.args())
)
bot.run()
More information and examples can be found here.
1 maintainer
Metadata
1 maintainer
Release files for simplematrixbotlib 2.13.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| simplematrixbotlib-2.13.0.tar.gz | 15.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| simplematrixbotlib-2.13.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 34.0 kB
Release files / simplematrixbotlib-2.13.0.tar.gz
| Download URL | simplematrixbotlib-2.13.0.tar.gz |
|---|---|
| Size | 15.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a843eaed39909332c1f60a76e51e468c2985497b286d20338c270c7729befb6b
|
|
BLAKE2b-256 checksum How to use checksums |
2fcb09c8f84b02b59cc3d58b9c6c805ac87e5d68d56a17aa6910da7204654c12
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.3.2 CPython/3.12.12 Linux/6.12.0-124.43.1.el10_1.x86_64
|
Release files / simplematrixbotlib-2.13.0-py3-none-any.whl
| Download URL | simplematrixbotlib-2.13.0-py3-none-any.whl |
|---|---|
| Size | 18.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e06687785877f47a4409b2dd8567134af1d823dfa60e16c23928953b7ccc1b2d
|
|
BLAKE2b-256 checksum How to use checksums |
e3fa7d2f37389623f41a2159605bcbc94c526339a2352a6526ae3b23e1f787a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.3.2 CPython/3.12.12 Linux/6.12.0-124.43.1.el10_1.x86_64
|
