Skip to content

mastodon_channel

diapason.channels.mastodon_channel

MastodonChannel — Mastodon adapter via Mastodon.py.

MastodonChannel

Bases: BaseChannel

Mastodon messaging channel adapter.

Uses the Mastodon API via Mastodon.py.

Parameters

api_base_url: Mastodon instance URL (e.g. https://mastodon.social). Falls back to MASTODON_API_BASE_URL env var. access_token: Mastodon access token. Falls back to MASTODON_ACCESS_TOKEN env var. bus: Optional event bus for publishing channel events.

connect()

Validate credentials and mark as connected.

disconnect()

Mark as disconnected.

list_channels()

Return available channel identifiers.

on_message(handler)

Register a callback for incoming messages.

send(channel, content, *, conversation_id='', metadata=None)

Post a status or send a direct message on Mastodon.

Parameters

channel: Visibility level (public, unlisted, private, direct) or a username to DM (prefix with @). content: Toot / message content.

status()

Return the current connection status.