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 Gateway(BaseGateway):
# 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 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 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!
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file slidge-0.4.0.tar.gz.
File metadata
- Download URL: slidge-0.4.0.tar.gz
- Upload date:
- Size: 579.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d6ae1ea28c3ba5f67518356b5545eabaa66f60e130bd0f7fbc2fe9513eedf715
|
|
| MD5 |
da9e92e5fb9012734155bbd9e21f43c8
|
|
| BLAKE2b-256 |
b8cc253ff417c210a47d05c740f848b4aa07831bff525ac495299e3b4595c083
|
File details
Details for the file slidge-0.4.0-py3-none-any.whl.
File metadata
- Download URL: slidge-0.4.0-py3-none-any.whl
- Upload date:
- Size: 210.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a128ca4f8a80c17098e4f0dc20adaf9174a2c7ce5f185a3e79fc2eecac7ab3b6
|
|
| MD5 |
2c4d803ee94bab773df3345fa31d75fe
|
|
| BLAKE2b-256 |
7429904175d5647812409d687d4f22121c0d374e005880c5ba11c1c17cafc2b5
|
