python telegram bot下载python telegram bot源代码下载

python telegram bot

其他源码

v21.7

下载

我们使您成为一个包装纸，您无法拒绝

在电报组中，我们有一个充满活力的开发人员社区。加入我们！

请继续关注我们的电报频道上的图书馆更新和新版本。

介绍

该库为Telegram Bot API提供了一个纯净的Python，异步界面。它与Python版本3.9+兼容。

除了纯API实施外，该库还具有几种便利方法和快捷方式以及许多高级类，以使机器人的开发变得轻松明了。这些类包含在telegram.ext子模块中。

安装库后，请务必查看有关与PTB合作的部分。

电报API支持

电报机器人API 7.11的所有类型和方法均由此库内部支持。此外，尚未本地包含的机器人API功能仍然可以如我们的Wiki中所述使用。

值得注意的功能

完全异步
方便的快捷方式方法，例如消息。reply_text
用静态类型的提示完全注释
可自定义且可扩展的接口
与Webhooks和投票无缝集成
全面的文档和示例

安装

您可以python-telegram-bot

$ pip install python-telegram-bot --upgrade

要安装预释放，请另外使用--pre标志。

您也可以从源安装python-telegram-bot ，尽管通常不需要。

$ git clone https://github.com/python-telegram-bot/python-telegram-bot
$ cd python-telegram-bot
$ pip install build
$ python -m build

验证发布

为了使您能够验证您下载的发布文件确实由python-telegram-bot团队提供，我们已经采取了以下措施。

从v21.4开始，所有版本均通过Sigstore签名。相应的签名文件将上传到GitHub版本页面。要验证签名，请安装Sigstore Python客户端，并按照说明验证GitHub Action的签名。作为--repository参数的输入，请使用值python-telegram-bot/python-telegram-bot 。

较早的版本用GPG密钥签名。签名将上传到GitHub版本页面和PYPI项目，并以后缀.asc结尾。请在这里找到公共钥匙。这些键以格式<first_version>-<last_version>.gpg命名。

此外，GITHUB发布页面还包含带有后缀.sha1的文件中发行文件的SHA1哈希。

依赖项及其版本

python-telegram-bot试图尽可能使用少数第三方依赖。但是，对于某些功能而言，使用第三方库比再次实施功能更理智。由于这些功能是可选的，因此默认情况下未安装相应的第三方依赖关系。相反，它们被列为可选依赖性。这允许对于不需要可选功能的用户避免不必要的依赖冲突。

唯一需要的依赖关系是httpx〜= 0.27， telegram.request.HTTPXRequest ，默认网络后端。

与其他库一起使用时， python-telegram-bot最有用。为了最大程度地减少依赖性冲突，我们试图在（可选）依赖项上的版本要求方面保持自由。另一方面，我们必须确保python-telegram-bot的稳定性，这就是为什么我们确实应用版本范围的原因。如果由于这些界限遇到依赖性冲突，请随时伸出援手。

可选依赖性

可以以可选的依赖项安装PTB：

pip install "python-telegram-bot[passport]"安装加密量> = 39.0.1库。如果要使用电报护照相关功能，请使用此功能。
pip install "python-telegram-bot[socks]"安装HTTPX [Socks]。如果要在Socks5服务器后面工作，请使用此功能。
pip install "python-telegram-bot[http2]"安装HTTPX [HTTP2]。如果要使用HTTP/2，请使用此。
pip install "python-telegram-bot[rate-limiter]"安装Aiolimiter〜= 1.1.0。如果要使用telegram.ext.AIORateLimiter ，请使用此。
pip install "python-telegram-bot[webhooks]"安装龙卷风〜= 6.4库。如果要使用telegram.ext.Updater.start_webhook / telegram.ext.Application.run_webhook ，请使用此操作。
pip install "python-telegram-bot[callback-data]"安装cachetools> = 5.3.3，<5.6.0库。如果要使用任意callback_data，请使用此功能。
pip install "python-telegram-bot[job-queue]"安装apscheduler〜= 3.10.4库并强制执行pytz> = 2018.6，其中pytz是APScheduler的依赖性。如果您想使用telegram.ext.JobQueue ，请使用此功能。

要安装多个可选依赖项，请通过逗号分隔，例如pip install "python-telegram-bot[socks,webhooks]" 。

此外，还提供了两个快捷方式：

pip install "python-telegram-bot[all]"安装所有可选依赖性。
pip install "python-telegram-bot[ext]"安装与telegram.ext相关的所有可选依赖项，即[rate-limiter, webhooks, callback-data, job-queue] 。

与PTB一起工作

安装库后，您可以开始使用它 - 让我们开始吧！

快速开始

我们的Wiki包含API的介绍，解释了如何通过python-telegram-bot访问纯机器人API。此外，教程：您的第一个机器人提供了介绍如何在telegram.ext模块的帮助下如何轻松编程聊天机器人。

资源

包装文档是python-telegram-bot的技术参考。它包含所有可用类，模块，方法和参数以及ChangElog的描述。
Wiki是有关python-telegram-bot和其他有用资源的不同功能的更多详细介绍，这些功能超出了技术文档。
我们的示例部分包含几个示例，这些示例展示了Bot API和python-telegram-bot的不同特征。即使不是您学习的方法，也要查看echobot.py 。这是大多数机器人的事实上的基础。这些示例的代码已发布到公共领域，因此您可以从抓取代码并在其顶部进行构建开始。
官方电报机器人API文档当然值得一读。

得到帮助

如果上面提到的资源没有回答您的问题或仅仅使您不知所措，则有几种获得帮助的方法。

在电报组中，我们有一个充满活力的开发人员社区。加入我们！在这里提出一个问题通常是将指针朝正确方向取出指针的最快方法。
通过开始讨论来提出问题。
您甚至可以使用Python-Telegram-bot标签在堆栈溢出上寻求帮助。

并发

自V20.0以来， python-telegram-bot建立在pythons asyncio模块的顶部。由于asyncio通常是单线线程， python-telegram-bot当前并不是要成为线程安全。 python-telegram-bots API的值得注意的部分可能会引起问题（例如种族条件），例如，在多线程设置中使用时包括：