Library for creating bots for telegram with Python.
Project description
Library for creating bots for telegram with Python.
OrigamiBot aims to make development of Telegram bots as easy and flexible as possible.
Installation
Origamibot is published in PyPI, so it can be installed with one simple command:
pip install origamibot
Basic concepts
OrigamiBot class is thing that will get updates form the server and dispatch them to your command holders and event listeners.
- Command Holder is a custom class that you create that exposes its methods as commands for bot
command holder can be attached to bot using
bot.add_commands(your_command_holder_class())
- Event listener is a class that inherits from
origamibot.util.Listener
and performs some actions on certain events(when itson_<something>
methods are called from OrigamiBot). Event listener can be added to bot withbot.add_listener(your_listener_object)
Usage example
Here goes a simple example of a bot:
from sys import argv
from time import sleep
from origamibot import OrigamiBot as Bot
from origamibot.listener import Listener
class BotsCommands:
def __init__(self, bot: Bot): # Can initialize however you like
self.bot = bot
def start(self, message): # /start command
self.bot.send_message(
message.chat.id,
'Hello user!\nThis is an example bot.')
def echo(self, message, value: str): # /echo [value: str] command
self.bot.send_message(
message.chat.id,
value
)
def add(self, message, a: float, b: float): # /add [a: float] [b: float]
self.bot.send_message(
message.chat.id,
str(a + b)
)
def _not_a_command(self): # This method not considered a command
print('I am not a command')
class MessageListener(Listener): # Event listener must inherit Listener
def __init__(self, bot):
self.bot = bot
self.m_count = 0
def on_message(self, message): # called on every message
self.m_count += 1
print(f'Total messages: {self.m_count}')
def on_command_failure(self, message, err=None): # When command fails
if err is None:
self.bot.send_message(message.chat.id,
'Command failed to bind arguments!')
else:
self.bot.send_message(message.chat.id,
'Error in command:\n{err}')
if __name__ == '__main__':
token = (argv[1] if len(argv) > 1 else input('Enter bot token: '))
bot = Bot(token) # Create instance of OrigamiBot class
# Add an event listener
bot.add_listener(MessageListener(bot))
# Add a command holder
bot.add_commands(BotsCommands(bot))
# We can add as many command holders
# and event listeners as we like
bot.start() # start bot's threads
while True:
sleep(1)
# Can also do some useful work i main thread
# Like autoposting to channels for example
Commands are added as methods of an object(be it class or instance of it), if their names don't start with _
which makes it possible to also contain some utility functions inside command container.
For the command to be called two conditions must be met:
- command name must match with method name
- command's arguments must match signature of a method
Method signature supports any number of arguments with simple typing(str
, int
, float
, bool
) or without a typing(in this case all arguments are strings by default), as well as variable number of arguments *args
. More complex types(as lists, tuples, custom object classes) are not supported, as bot does not know how to parse them, and I don't want to enforce my own parsing algorithm, but bot will still attempt to convert it like cls(argument)
, but a correct result is not guaranteed.
Boolean values are considered True if their string representation is in
{'True', 'true', '1'}
, and False if in{'False', 'false', '0'}
Project details
Release history Release notifications | RSS feed
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
Hashes for origamibot-2.0.13-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8bc23766f5f8619d40bff5cfd2b040a726af0d7117b3b615f689a8a88b91851c |
|
MD5 | 74f7326ec385de19e8826aba43e1c0eb |
|
BLAKE2b-256 | 1550e31dbe0f74780bf6080e1d9da94c1137156dcd883da6b6c574bcebf0b2d8 |