pyTelegramBotAPI 4.16.1__tar.gz → 4.18.0__tar.gz

{pytelegrambotapi-4.16.1 → pytelegrambotapi-4.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: pyTelegramBotAPI
-Version: 4.16.1
+Version: 4.18.0
 Summary: Python Telegram bot api.
 Project-URL: Homepage, https://github.com/eternnoir/pyTelegramBotAPI
 Project-URL: Documentation, https://pytba.readthedocs.org
@@ -55,7 +55,7 @@ Description-Content-Type: text/markdown
 <p align="center">A simple, but extensible Python implementation for the <a href="https://core.telegram.org/bots/api">Telegram Bot API</a>.</p>
 <p align="center">Both synchronous and asynchronous.</p>
 
-## <p align="center">Supported Bot API version: <a href="https://core.telegram.org/bots/api#february-16-2024">7.1</a>!
+## <p align="center">Supported Bot API version: <a href="https://core.telegram.org/bots/api#march-31-2024">7.2</a>!
 
 <h2><a href='https://pytba.readthedocs.io/en/latest/index.html'>Official documentation</a></h2>
 <h2><a href='https://pytba.readthedocs.io/ru/latest/index.html'>Official ru documentation</a></h2>
@@ -933,6 +933,8 @@ Here are some examples of template:
 * [AwesomeChatGPTBot](https://github.com/Kourva/AwesomeChatGPTBot) - Simple ChatGTP-3.5 bot. It is FREE and can remember chat history for a while With pre-defined roles!
 * [QR-Code For You Bot](https://t.me/qrcode_for_you_bot) ([source](https://github.com/arashnm80/qrcode-for-you-bot)) by [Arashnm80](https://github.com/arashnm80). Telegram qrcode generator bot created with pyhton and telebot.
 * [Best Instagram Downloader Bot](https://t.me/Best_Instagram_Downloader_Bot) ([source](https://github.com/arashnm80/best-instagram-downloader)) by [Arashnm80](https://github.com/arashnm80). Free and open source telegram bot to download posts and reels from Instagram.
-* [Personal bot for ChatGPT & Bard](https://github.com/Simatwa/pyTelegramBotAPI.git) by [Simatwa](https://github.com/Simatwa/telegram-chatbots). Chat with ChatGPT & Bard on the go.
+* [4K YouTube Downloader](https://github.com/hansanaD/TelegramYTDLBot/) - Youtube Downloader with upto 4K resolution support. 
+* [DrinkGenius-Bot](https://t.me/cocktail_recommendation_bot) ([source](https://github.com/Povladarchik/DrinkGenius-Bot)) by [Povladarchik](https://github.com/Povladarchik). Your personal assistant in the world of cocktails.
+* [Pytgpt-Bot](https://t.me/pytgpt_bot) ([source](https://github.com/Simatwa/pytgpt-bot)) by [Smartwa](https://github.com/Simatwa). AI powered bot for chatting, text-to-image and text-to-speech conversions.
 
 **Want to have your bot listed here? Just make a pull request. Only bots with public source code are accepted.**

{pytelegrambotapi-4.16.1 → pytelegrambotapi-4.18.0}/README.md

@@ -10,7 +10,7 @@
 <p align="center">A simple, but extensible Python implementation for the <a href="https://core.telegram.org/bots/api">Telegram Bot API</a>.</p>
 <p align="center">Both synchronous and asynchronous.</p>
 
-## <p align="center">Supported Bot API version: <a href="https://core.telegram.org/bots/api#february-16-2024">7.1</a>!
+## <p align="center">Supported Bot API version: <a href="https://core.telegram.org/bots/api#march-31-2024">7.2</a>!
 
 <h2><a href='https://pytba.readthedocs.io/en/latest/index.html'>Official documentation</a></h2>
 <h2><a href='https://pytba.readthedocs.io/ru/latest/index.html'>Official ru documentation</a></h2>
@@ -888,6 +888,8 @@ Here are some examples of template:
 * [AwesomeChatGPTBot](https://github.com/Kourva/AwesomeChatGPTBot) - Simple ChatGTP-3.5 bot. It is FREE and can remember chat history for a while With pre-defined roles!
 * [QR-Code For You Bot](https://t.me/qrcode_for_you_bot) ([source](https://github.com/arashnm80/qrcode-for-you-bot)) by [Arashnm80](https://github.com/arashnm80). Telegram qrcode generator bot created with pyhton and telebot.
 * [Best Instagram Downloader Bot](https://t.me/Best_Instagram_Downloader_Bot) ([source](https://github.com/arashnm80/best-instagram-downloader)) by [Arashnm80](https://github.com/arashnm80). Free and open source telegram bot to download posts and reels from Instagram.
-* [Personal bot for ChatGPT & Bard](https://github.com/Simatwa/pyTelegramBotAPI.git) by [Simatwa](https://github.com/Simatwa/telegram-chatbots). Chat with ChatGPT & Bard on the go.
+* [4K YouTube Downloader](https://github.com/hansanaD/TelegramYTDLBot/) - Youtube Downloader with upto 4K resolution support. 
+* [DrinkGenius-Bot](https://t.me/cocktail_recommendation_bot) ([source](https://github.com/Povladarchik/DrinkGenius-Bot)) by [Povladarchik](https://github.com/Povladarchik). Your personal assistant in the world of cocktails.
+* [Pytgpt-Bot](https://t.me/pytgpt_bot) ([source](https://github.com/Simatwa/pytgpt-bot)) by [Smartwa](https://github.com/Simatwa). AI powered bot for chatting, text-to-image and text-to-speech conversions.
 
 **Want to have your bot listed here? Just make a pull request. Only bots with public source code are accepted.**

{pytelegrambotapi-4.16.1 → pytelegrambotapi-4.18.0}/docs/source/conf.py

@@ -1,72 +1,72 @@
-# Configuration file for the Sphinx documentation builder.
-#
-# This file only contains a selection of the most common options. For a full
-# list see the documentation:
-# https://www.sphinx-doc.org/en/master/usage/configuration.html
-
-# -- Path setup --------------------------------------------------------------
-
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-#
-# import os
-# import sys
-# sys.path.insert(0, os.path.abspath('.'))
-
-
-# -- Project information -----------------------------------------------------
-
-project = 'pyTelegramBotAPI Documentation'
-copyright = '2022-2023, coder2020official'
-author = 'coder2020official'
-
-# The full version, including alpha/beta/rc tags
-release = '4.16.1'
-
-
-# -- General configuration ---------------------------------------------------
-
-# Add any Sphinx extension module names here, as strings. They can be
-# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
-# ones.
-extensions = [
-    'sphinx.ext.autosectionlabel',
-    'sphinx.ext.autodoc',
-    "sphinx.ext.autosummary",
-    "sphinx.ext.napoleon",
-    "sphinx_copybutton",
-    
-]
-
-# Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
-
-# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-# This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = []
-
-
-# -- Options for HTML output -------------------------------------------------
-
-# The theme to use for HTML and HTML Help pages.  See the documentation for
-# a list of builtin themes.
-#
-html_theme = 'furo'
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
-#html_logo = 'logo.png'
-html_theme_options = {
-    "light_css_variables": {
-        "color-brand-primary": "#7C4DFF",
-        "color-brand-content": "#7C4DFF",
-    },
-    "light_logo": "logo.png",
-    "dark_logo": "logo2.png",
-}
-
-locale_dirs = ["locales/"]
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+# import os
+# import sys
+# sys.path.insert(0, os.path.abspath('.'))
+from datetime import datetime
+
+# -- Project information -----------------------------------------------------
+
+project = 'pyTelegramBotAPI'
+author = 'coder2020official'
+copyright = f'2022-{datetime.now().year}, {author}'
+
+# The full version, including alpha/beta/rc tags
+release = '4.18.0'
+
+
+# -- General configuration ---------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    'sphinx.ext.autosectionlabel',
+    'sphinx.ext.autodoc',
+    "sphinx.ext.autosummary",
+    "sphinx.ext.napoleon",
+    "sphinx_copybutton",
+    
+]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = []
+
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = 'furo'
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+#html_logo = 'logo.png'
+html_theme_options = {
+    "light_css_variables": {
+        "color-brand-primary": "#7C4DFF",
+        "color-brand-content": "#7C4DFF",
+    },
+    "light_logo": "logo.png",
+    "dark_logo": "logo2.png",
+}
+
+locale_dirs = ["locales/"]

{pytelegrambotapi-4.16.1 → pytelegrambotapi-4.18.0}/examples/asynchronous_telebot/echo_bot.py

@@ -1,27 +1,25 @@
-#!/usr/bin/python
-
-# This is a simple echo bot using the decorator mechanism.
-# It echoes any incoming text messages.
-
-from telebot.async_telebot import AsyncTeleBot
-bot = AsyncTeleBot('TOKEN')
-
-
-
-# Handle '/start' and '/help'
-@bot.message_handler(commands=['help', 'start'])
-async def send_welcome(message):
-    await bot.reply_to(message, """\
-Hi there, I am EchoBot.
-I am here to echo your kind words back to you. Just say anything nice and I'll say the exact same thing to you!\
-""")
-
-
-# Handle all other messages with content_type 'text' (content_types defaults to ['text'])
-@bot.message_handler(func=lambda message: True)
-async def echo_message(message):
-    await bot.reply_to(message, message.text)
-
-
-import asyncio
-asyncio.run(bot.polling())
+#!/usr/bin/python
+
+# This is a simple echo bot using the decorator mechanism.
+# It echoes any incoming text messages.
+import asyncio
+
+from telebot.async_telebot import AsyncTeleBot
+
+bot = AsyncTeleBot('TOKEN')
+
+
+# Handle '/start' and '/help'
+@bot.message_handler(commands=['help', 'start'])
+async def send_welcome(message):
+    text = 'Hi, I am EchoBot.\nJust write me something and I will repeat it!'
+    await bot.reply_to(message, text)
+
+
+# Handle all other messages with content_type 'text' (content_types defaults to ['text'])
+@bot.message_handler(func=lambda message: True)
+async def echo_message(message):
+    await bot.reply_to(message, message.text)
+
+
+asyncio.run(bot.polling())

pytelegrambotapi-4.18.0/examples/asynchronous_telebot/message_reaction_example.py

@@ -0,0 +1,35 @@
+#!/usr/bin/python3
+
+# This is a simple bot using message reactions (emoji)
+# https://core.telegram.org/bots/api#reactiontype
+# https://core.telegram.org/bots/api#update
+# allowed_updates: Specify an empty list to receive all update types except, chat_member, message_reaction, and message_reaction_count. 
+# If you want to receive message_reaction events, you cannot simply leave the allowed_updates=None default value. 
+# The default list of events does not include chat_member, message_reaction, and message_reaction_count events. 
+# You must explicitly specify all the events you wish to receive and add message_reaction to this list. 
+# It’s also important to note that after using allowed_updates=[...], in the future, using allowed_updates=None will mean 
+# that the list of events you will receive will consist of the events you last explicitly specified.
+
+import random
+from telebot.async_telebot import AsyncTeleBot
+from telebot.types import ReactionTypeEmoji
+
+API_TOKEN = '<api_token>'
+bot = AsyncTeleBot(API_TOKEN)
+
+
+
+# Send a reactions to all messages with content_type 'text' (content_types defaults to ['text'])
+@bot.message_handler(func=lambda message: True)
+async def send_reaction(message):
+    emo = ["\U0001F525", "\U0001F917", "\U0001F60E"]  # or use ["🔥", "🤗", "😎"]
+    await bot.set_message_reaction(message.chat.id, message.id, [ReactionTypeEmoji(random.choice(emo))], is_big=False)
+
+
+@bot.message_reaction_handler(func=lambda message: True)
+async def get_reactions(message):
+    await bot.reply_to(message, f"You changed the reaction from {[r.emoji for r in message.old_reaction]} to {[r.emoji for r in message.new_reaction]}")
+
+
+import asyncio
+asyncio.run(bot.infinity_polling(allowed_updates=['message', 'message_reaction']))

pytelegrambotapi-4.18.0/examples/message_reaction_example.py

@@ -0,0 +1,33 @@
+#!/usr/bin/python3
+
+# This is a simple bot using message reactions (emoji)
+# https://core.telegram.org/bots/api#reactiontype
+# https://core.telegram.org/bots/api#update
+# allowed_updates: Specify an empty list to receive all update types except, chat_member, message_reaction, and message_reaction_count. 
+# If you want to receive message_reaction events, you cannot simply leave the allowed_updates=None default value. 
+# The default list of events does not include chat_member, message_reaction, and message_reaction_count events. 
+# You must explicitly specify all the events you wish to receive and add message_reaction to this list. 
+# It’s also important to note that after using allowed_updates=[...], in the future, using allowed_updates=None will mean 
+# that the list of events you will receive will consist of the events you last explicitly specified.
+
+import random
+import telebot
+from telebot.types import ReactionTypeEmoji
+
+API_TOKEN = '<api_token>'
+bot = telebot.TeleBot(API_TOKEN)
+
+
+# Send a reactions to all messages with content_type 'text' (content_types defaults to ['text'])
+@bot.message_handler(func=lambda message: True)
+def send_reaction(message):
+    emo = ["\U0001F525", "\U0001F917", "\U0001F60E"]  # or use ["🔥", "🤗", "😎"]
+    bot.set_message_reaction(message.chat.id, message.id, [ReactionTypeEmoji(random.choice(emo))], is_big=False)
+
+
+@bot.message_reaction_handler(func=lambda message: True)
+def get_reactions(message):
+    bot.reply_to(message, f"You changed the reaction from {[r.emoji for r in message.old_reaction]} to {[r.emoji for r in message.new_reaction]}")
+
+
+bot.infinity_polling(allowed_updates=['message', 'message_reaction'])

pytelegrambotapi-4.18.0/examples/serverless/flask_google_cloud_bot/.gcloudignore

@@ -0,0 +1 @@
+env/

pytelegrambotapi-4.18.0/examples/serverless/flask_google_cloud_bot/app.yaml

@@ -0,0 +1,4 @@
+runtime: python38
+
+env_variables:
+  BUCKET_NAME: "your-google-application"

pytelegrambotapi-4.18.0/examples/serverless/flask_google_cloud_bot/main.py

@@ -0,0 +1,65 @@
+'''
+Simple bot for Google cloud deployment.
+
+Docs:
+https://cloud.google.com/run/docs/quickstarts/build-and-deploy/deploy-python-service
+
+1. Receive your bot's token from https://t.me/BotFather
+
+2. Create a Google Cloud project. https://cloud.google.com/resource-manager/docs/creating-managing-projects
+
+3. Install the Google Cloud CLI. https://cloud.google.com/sdk/docs/install
+
+4. Move to telegram_google_cloud_bot folder
+
+cd telegram_google_cloud_bot/
+
+5. Initialize the gcloud CLI:
+
+gcloud init
+
+6. To set the default project for your Cloud Run service:
+
+gcloud config set project PROJECT_ID
+
+7. Deploy:
+
+gcloud run deploy
+'''
+
+import os
+
+from flask import Flask, request
+
+import telebot
+
+TOKEN = 'token_from_botfather'
+
+bot = telebot.TeleBot(TOKEN)
+
+app = Flask(__name__)
+
+
+@bot.message_handler(commands=['start'])
+def start(message):
+    bot.reply_to(message, 'Hello, ' + message.from_user.first_name)
+
+
+@bot.message_handler(func=lambda message: True, content_types=['text'])
+def echo_message(message):
+    bot.reply_to(message, message.text)
+
+
+@app.route('/' + TOKEN, methods=['POST'])
+def getMessage():
+    json_string = request.get_data().decode('utf-8')
+    update = telebot.types.Update.de_json(json_string)
+    bot.process_new_updates([update])
+    return '!', 200
+
+
+@app.route('/')
+def webhook():
+    bot.remove_webhook()
+    bot.set_webhook(url='https://mydomain.com/' + TOKEN)
+    return '!', 200

pytelegrambotapi-4.18.0/examples/serverless/flask_google_cloud_bot/requirements.txt

@@ -0,0 +1,4 @@
+pyTelegramBotAPI==4.11.0
+Flask==3.0.0
+gunicorn==22.0.0
+Werkzeug==3.0.3

{pytelegrambotapi-4.16.1 → pytelegrambotapi-4.18.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pyTelegramBotAPI"
-version = "4.16.1"
+version = "4.18.0"
 description = "Python Telegram bot api."
 authors = [{name = "eternnoir", email = "eternnoir@gmail.com"}]
 license = {text = "GPL2"}

{pytelegrambotapi-4.16.1 → pytelegrambotapi-4.18.0}/requirements.txt

@@ -1,4 +1,4 @@
 pytest
 requests==2.31.0
 wheel==0.38.1
-aiohttp==3.9.0
+aiohttp==3.9.4