telegram-cli 0.2.0

Python CLI tool and library for sending messages to Telegram

telegram-cli

Python CLI tool and library for sending messages to Telegram

Installation

Install this tool using pip:

pip install telegram-cli

Usage

Basic

For sending a simple text message to a user o group, run:

export TELEGRAM_TOKEN='bot123456:de4dbeefde4dbeefde4dbeefde4dbeefde4dbeef' 

$ tgm message send --text 'Hello' --chat-id 123456
message-id: 676

Text from a stream (file or stdin)

For sending the content of a text file as message text:

# you have a text file with a message you want to send
echo "hey dude" > message.txt 

# (1) use the `--text-file` option
tgm message send --chat-id 123456 --text-file message.txt 

# (2) use `<`
tgm message send --chat-id 123456 < message.txt 

# (3) use `|`
cat message.txt | tgm message send --chat-id 123456
# or
echo "hey dude, it's me again" | tgm message send --chat-id 123456 

# (4) type your message and send it by typing `CTRL+D`
tgm message send --chat-id 123456
Hey dude, yeah it's me again!
<CTRL+D>

Parse modes

For using one of the supported parse modes (MarkdownV2 or HTML) of the entities in the message, run:

tgm message send --parse-mode "MarkdownV2" --text '**Hello**' --chat-id 123456

tgm message send --parse-mode "HTML" --text '<b>Hello</b>' --chat-id 123456

See the available formatting options to learn how to use --parse-mode.

For help, run:

telegram-cli --help

You can also use:

python -m telegram_cli --help

Development

To contribute to this tool, first checkout the code. Then create a new virtual environment:

cd telegram-cli
python -m venv venv
source venv/bin/activate

Now install the dependencies and test dependencies:

pip install -e '.[test]'

To run the tests:

pytest