botter

Release 0.1.1

Python messenger bot aggregator, supporting Discord, Telegram, and potentially others

Homepage Repository PyPI

Keywords
bot, discord, python, telegram
License
BSD-1-Clause
Install
pip install botter==0.1.1

Documentation

Botter - Simple interface for creating cross-messenger bots

Botter is a framework which allows your bots run in any available messenger. Currently, there are only one implementation for Discord, but it is easy to implement other platforms.

Okay, let's get started!

Getting Started

Creating an Application

At first, you should register a bot in the desired platform. As all messengers provide different ways to do so, we will not describe this process here.

Create Handler

Botter uses event-based architecture, with a most-common event - MessageEvent. Events are handled by EventHandler's.

So, let's create out own:

from botter.api import *
from botter.api.handlers import *

class SimpleEchoHandler(ReplyHandler):
    async def handle_message(self, message: InboundMessage) -> Message:
        return Message(f"You've said:\n" + message.text)

Here we use the ReplyHandler, which:

  • Nests MessageHandler
  • Checks the event is MessageEvent
  • Calls method handle_message() with the message from event.
  • If this method returns Message rather than None, ReplyHandler would send it to server with a mention to the original message's author.

Crate a Bot

Then we need to create a Bot - object that aggregates handlers and mappings to the implementation. Here we use discord driver as an example.

from botter.discord import DiscordBot

class EchoBot(Bot[DiscordBot]):
    token = 'INSERT_YOUR_TOKEN_HERE'
    event_handlers = [ SimpleEchoHandler ]
    client = DiscordBot(token=token)

Okay, let's try it out!

Simple EchoBot - Discord

Wow! It works!

Extending Events

Now, let's try to have some fun with the events.

Stats

Dependencies
5
Dependent packages
0
Dependent repositories
1
Total releases
11
Latest release
First release
Stars
0
Forks
0
Contributors
0
SourceRank
7

Development practices

Source repo 2FA enabled
TEXT!
Package manager 2FA enabled
TEXT!
Is security responsive
TEXT!
Dependencies are managed
TEXT!
Issue-free release available
TEXT!
Succession plan available
TEXT!
Package manager 2FA enabled
TEXT!

The Tidelift Subscription provides access to a continuously curated stream of human-researched and maintainer-verified data on open source packages and their licenses, releases, vulnerabilities, and development practices.

Learn more →

Releases

0.1.4
0.1.3
0.1.2
0.1.1
0.1.0
0.0.7
0.0.6
0.0.5
0.0.4
0.0.2
See all 11 releases

Something wrong with this page? Make a suggestion

Export .ABOUT file for this package

Last synced: 2023-11-30 16:24:52 UTC

Login to resync this project