A Telegram bot that you can log to from Python and manage long running processes.
Project description
LogBot
A Telegram bot that you can log to from Python and manage long running processes.
Quickstart
NOTE: The following example is using a demo bot that I personally host at apiad.net:6778. This bot can and will be stopped, restarted or even destroyed without notice. Refer to the section on Setting your own for more details.
First, go to Telegram and open a chat with LogBot (Demo). You'll see this initial message.
Hit the Start button, and the bot will send you a secret token:
Now with this secret token you can communicate to the bot through HTTP. The protocol is very simple. Just a send a POST
request to the bot's API with an encoded json
data:
curl -XPOST http://apiad.net:6778 -d \
"{ \
\"token\": \"ytp96gWZ8uHE\", \
\"msg\": \"Hello World\" \
}"
Voilá, your message will be forwared to Telegram:
You can send messages with Markdown formatting:
curl -XPOST http://apiad.net:6778 -d \
"{ \
\"token\": \"ytp96gWZ8uHE\", \
\"msg\": \"*Hello* _World_\" \
}"
Finally, you can send actions, that will be rendered as buttons in Telegram. When you click the button, and only when you click it, you will get a response back with the clicked option:
curl -XPOST http://apiad.net:6778 -d \
"{ \
\"token\": \"ytp96gWZ8uHE\", \
\"msg\": \"Wanna try?\", \
\"actions\": [\"Yes\", \"No way\"] \
}"
{"msg":"Wanna try?","response":"Yes"}
NOTE: By default you have 60 seconds to answer before a response timeout is raised. This hard limit might be changed in future versions.
Python API
If you talk Python, you can clone this project and use a set of simple tools to skip all that curl
. send
simply sends the message.
>>> from logbot import Client
>>> c = Client(token="<token>", host="http://apiad.net", port=6778)
>>> c.send("Hello World")
You can also use two more utility methods. ask
will send the corresponding questions as buttons and return the reply:
>>> c.ask("Do you?", "A", "B", "C")
'C' # Supposedly you hit C in Telegram
yes
will simply send Yes
and No
and return True
or False
:
>>> if c.yes("Do you?"):
>>> print("It does!")
'It does!' # Supposedly you hit Yes in Telegram
These are also available as simple functions, which receive token
, host
and port
on every call. The Client
class just simplifies passing those values all the time.
What can I do with this?
Some simple ideas:
- Log directly into Telegram from your code. For example, using Python
request
you can easily make any long-running script to periodically send updates. - Monitor a server. Using
bash
,curl
andcron
you can send yourself periodically info about your CPU, memory and I/O ussage. - Quick responses on Telegram. By using the response actions, you can interact with running code, either to take decisions, kill long running processes, retry things that broke, etc. Your imagination is the limit.
Setting up your own
For testing, and while my server handles it, you can use the bot I have set up. It's free and for that reason I might decide to turn it off at any given time without any advice. So, if you want a long time working solution, you will have to set up your own.
- First, create your Telegram bot with BotFather. If you don't know what I mean, read the Telegram documentation on bots. It's all over the Internet.
- Second, BotFather will give you a
TOKEN
. Make sure to write it down. - Third, clone this repository.
- Fourth,
pipenv install
the dependencies. - Finally,
export TOKEN=<your-token>
. - You can run
pipenv run python -m logbot
now. It will listen by default atlocalhost:6778
. - You can change the
HOST
andPORT
with environment variables.
Collaboration
It's MIT, so you know the drill. Fork, edit, pull request, repeat.
License
MIT License
Copyright (c) 2019 Alejandro Piad
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Project details
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 logbot_telegram-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 541b50188dda4e5128019bdf38386120bff15a47ce6cdea701217733c6c1ab3f |
|
MD5 | 6924d3e404c6147e1586974519628c6c |
|
BLAKE2b-256 | fc08392b67dd3658715975e1885fecbf1fe06560a54aa1a5dae8af7e416114ae |