tgbsms 1.0.0

Telegram Bot Short Message Service: Small requests wrapper to send message to chat via Telegram Bot API

tgbsms - Telegram Bot Short Message Service

tgbsms is a simple Python utility for sending short messages via Telegram using the Telegram Bot API.

Features

• Trims the text to fit Telegram's maximum length
• Sends POST request to Telegram bot API

Installation

You can install tgbsms directly from PyPI using pip:

pip install tgbsms

Usage

To send a message using the tgbsms, you can use the send_message function. Here is an example:

from tgbsms import send_message

send_message("test", telegram_chat_id="<chat_id>", telegram_bot_token="<your_bot_token>")

Parameters:

• text: The message to send (string). If the message exceeds 4000 characters, it will be cropped.
• telegram_chat_id: (Optional, read below) The ID of the chat where the message will be sent. This can be an integer or a string.
• telegram_bot_token: (Optional, read below) Your bot's TOKEN provided by Telegram.

Environment Variables

If you prefer not to pass the telegram_bot_token and telegram_chat_id directly, you can set them as environment variables:

• TELEGRAM_BOT_TOKEN: Your Telegram bot's TOKEN.
• TELEGRAM_CHAT_ID: The chat ID for the message.

Once the environment variables are set, the function can be used without passing these parameters directly.

export TELEGRAM_BOT_TOKEN="<your_bot_token>"
export TELEGRAM_CHAT_ID="<chat_id>"

And then:

from tgbsms import send_message

send_message("test")

License

This project is licensed under the MIT License. See the LICENSE file for details.