Slidge is an XMPP (puppeteer) gateway library in python. It makes writing gateways to other chat networks (legacy modules) as frictionless as possible. It supports fancy IM features, such as (emoji) reactions, replies, and retractions. The full list of supported XEPs in on xmpp.org.
Status
Slidge is beta-grade software. It support groups and 1:1 chats. Try slidge and give us some feedback, through the MUC or the issue tracker. Don't be shy!
Usage
A minimal (and fictional!) slidge-powered "legacy module" looks like this:
from cool_chat_lib import CoolClient
from slidge import BaseGateway, BaseSession
from slidge.contact import LegacyContact
from slidge.group import LegacyMUC
from slidge.db import GatewayUser
from slidge.util.types import XMPPMessage
class Session(BaseSession):
async def login(self, user: GatewayUser) -> None:
self.legacy_client = CoolClient(
login=user.legacy_module_data["username"],
password=user.legacy_module_data["password"],
)
await self.legacy_client.login()
class Gateway(BaseGateway[Session]):
# Various aspects of the gateway component are configured as class
# attributes of the concrete Gateway class
COMPONENT_NAME = "Gateway to the super duper chat network"
class Contact(LegacyContact):
async def on_message(self, msg: XMPPMessage) -> str:
"""
Triggered when the slidge user sends an XMPP message through the gateway
"""
sent = self.session.legacy_client.send_message(
text=text, destination=self.legacy_id
)
return str(sent.message_id)
There's more in the tutorial!
Installation
⚠️ Slidge is a lib for gateway developers, if you are an XMPP server admin and want to install gateways on your server, you are looking for a slidge-based gateway. or the slidge-debian bundle.
Slidge is available on codeberg and pypi. Refer to the docs for details.
About privacy
Slidge (and most if not all XMPP gateway that I know of) will break end-to-end encryption, or more precisely one of the 'ends' become the gateway itself. If privacy is a major concern for you, my advice would be to:
- use XMPP + OMEMO
- self-host your gateways
- have your gateways hosted by someone you know AFK and trust
Related projects
Thank you, Trung, for the slidge logo!
Metadata
Release files for slidge 0.5.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| slidge-0.5.3.tar.gz | 556.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| slidge-0.5.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 801.4 kB
Release files / slidge-0.5.3.tar.gz
| Download URL | slidge-0.5.3.tar.gz |
|---|---|
| Size | 556.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
09f8c8c19a6a9a2a3c4a21602a1da19f437a2ec62e333b67d8cdfd9bd1d7c32a
|
|
BLAKE2b-256 checksum How to use checksums |
911401a2376308fbea9967c296f1c061e6fb5e00c22c35beff0cf4e36c8ac1c1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / slidge-0.5.3-py3-none-any.whl
| Download URL | slidge-0.5.3-py3-none-any.whl |
|---|---|
| Size | 244.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
27262e851eeec59f4e282ed3dc2ed0c04ebbc1e1a26d670497324c76ad3b57cc
|
|
BLAKE2b-256 checksum How to use checksums |
f624793d266f8b775c5c48c3f8f8f73ed7bdc4f3e81cabc464e55f7ebdd31913
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
