ボットです(Bo-to Desu!)！¶
An automatically expanding Telegram bot API that supports the latest Telegram features.
Getting Started¶
Wait, what? automatically expanding? How does it work?
Unlike the other libraries, the api methods are not pre-defined in this library, they are defined on the first invocation of the method. The arguments during the invocation become the corresponding fields in the form-data which will then be encoded into json or urlencoded or multipart and be submitted with a POST request to the telegram server. Thus, all the arguments provided when invoking the api methods should be keyword arguments, because Botodesu has no knowledge of the Telegram API in advanced.
Also, to be comply with the PEP8, Botodesu will automatically remove all the underscores for the api methods.
Note
The Telegram API methods are case-insensitive.
Tip
The content of the response of Botodesu can be accessed as attributes if no conflict methods can be found in the dict class.
Important
Absolutely, the expansion is not unlimited. However, this would work for a relative long period until the telegram API makes significant breaking changes (e.g.:add a version number to the request URL).
Uploading Files¶
You can uploading files by including files as botodesu.BotoFairu, the request will automatically turn into a multipart/form-data request.
Contribution¶
Botodesu is an early project. All kinds of contributions are warmly welcomed.
The source code is hosted on GitHub.
Example¶
An Echo Bot:
async with botodesu.Boto("YOUR_API_KEY") as boto:
async for update in boto:
if "message" not in update.keys():
continue
message = update.message
if "text" not in message.keys():
continue
text = message.text
await boto.send_message(
chat_id=message.chat.id,
text="You said: \"{}\".".format(text),
reply_to_message_id=message.message_id)
Prerequisites¶
- python_version>=3.5.2
- aiohttp>=1.2.0
Try it out!¶
$ pip install -U botodesu