Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Consider using release 2.13.1 instead.
Reason given by maintainers: no difference from 2.7.0

Simple-Matrix-Bot-Lib

(Version 2.7.1)

Simple-Matrix-Bot-Lib is a Python bot library for the Matrix ecosystem built on matrix-nio.

View on Github 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 github.

Installation from PyPi:

python -m pip install simplematrixbotlib

Read the docs to learn how to install E2E encryption support.

Download from github:

git clone --branch master https://github.com/i10b/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.

Metadata

Release files for simplematrixbotlib 2.7.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for simplematrixbotlib 2.7.1
File	Size	Uploaded
simplematrixbotlib-2.7.1.tar.gz	14.0 kB	Oct 3, 2022	Details

Built distribution (wheel)

Table of built distributions (wheels) for simplematrixbotlib 2.7.1
File	Interpreter	ABI	Platform	Reset
simplematrixbotlib-2.7.1-py3-none-any.whl 15.4 kB Oct 3, 2022	Python 3	none	any	Details

Total release size: 29.4 kB

Release files / simplematrixbotlib-2.7.1.tar.gz

Download URL	simplematrixbotlib-2.7.1.tar.gz
Size	14.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`db6d603c109c7cc8ac3a4f61c1d31cfcc0585c88d40f65ecdd7b7f96e05b8763`
BLAKE2b-256 checksum How to use checksums	`9ec547485ae0e5bdfbe99f43c36586bde13dc959340746af7a21d6334ee0f362`
Upload date	Oct 3, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.1.14 CPython/3.10.7 Linux/5.19.12-1-default`

Release files / simplematrixbotlib-2.7.1-py3-none-any.whl

Download URL	simplematrixbotlib-2.7.1-py3-none-any.whl
Size	15.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ab07f1d8bd9596e42c6012e8b9e0bd8ae673061c00318fe63f33ea505b1d4afc`
BLAKE2b-256 checksum How to use checksums	`d69c52becfb47a3226dc086bc7d8dcd1bfd1681aa6ea6ba83f6bad56fff597a0`
Upload date	Oct 3, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.1.14 CPython/3.10.7 Linux/5.19.12-1-default`