python telegram bot
v21.7
Kami telah membuat Anda menjadi pembungkus yang tidak dapat Anda tolak
Kami memiliki komunitas pengembang yang bersemangat yang saling membantu dalam kelompok telegram kami. Bergabunglah dengan kami!
Nantikan pembaruan perpustakaan dan rilis baru di saluran telegram kami .
Perpustakaan ini menyediakan antarmuka python murni, asinkron untuk API Bot Telegram. Ini kompatibel dengan versi Python 3.9+ .
Selain implementasi API murni, perpustakaan ini menampilkan beberapa metode kenyamanan dan jalan pintas serta sejumlah kelas tingkat tinggi untuk membuat pengembangan bot mudah dan mudah. Kelas -kelas ini terkandung dalam Submodule telegram.ext .
Setelah menginstal perpustakaan, pastikan untuk memeriksa bagian bekerja dengan PTB.
Semua jenis dan metode Telegram Bot API 7.11 secara asli didukung oleh perpustakaan ini. Selain itu, fungsi BOT API yang belum dimasukkan secara asli masih dapat digunakan seperti yang dijelaskan dalam wiki kami.
Anda dapat menginstal atau meningkatkan python-telegram-bot melalui
$ pip install python-telegram-bot --upgrade Untuk menginstal pra-rilis, gunakan-bendera --pre sebagai tambahan.
Anda juga dapat memasang python-telegram-bot dari sumber, meskipun ini biasanya tidak diperlukan.
$ git clone https://github.com/python-telegram-bot/python-telegram-bot
$ cd python-telegram-bot
$ pip install build
$ python -m build Untuk memungkinkan Anda memverifikasi bahwa file rilis yang Anda unduh memang disediakan oleh tim python-telegram-bot , kami telah mengambil langkah-langkah berikut.
Dimulai dengan V21.4, semua rilis ditandatangani melalui Sigstore. File tanda tangan yang sesuai diunggah ke halaman Rilis GitHub. Untuk memverifikasi tanda tangan, silakan instal klien Sigstore Python dan ikuti instruksi untuk memverifikasi tanda tangan dari tindakan GitHub. Sebagai input untuk parameter --repository , silakan gunakan nilai python-telegram-bot/python-telegram-bot .
Rilis sebelumnya ditandatangani dengan kunci GPG. Tanda tangan diunggah ke halaman Rilis GitHub dan proyek PYPI dan diakhiri dengan akhiran .asc . Temukan kunci publik di sini. Kunci dinamai dalam format <first_version>-<last_version>.gpg .
Selain itu, halaman rilis GitHub juga berisi hash sha1 dari file rilis dalam file dengan akhiran .sha1 .
python-telegram-bot mencoba menggunakan sedikit ketergantungan pihak ke-3. Namun, untuk beberapa fitur menggunakan perpustakaan pihak ke -3 lebih waras daripada mengimplementasikan fungsionalitas lagi. Karena fitur -fitur ini opsional , dependensi pihak ke -3 yang sesuai tidak diinstal secara default. Sebaliknya, mereka terdaftar sebagai dependensi opsional. Hal ini memungkinkan untuk menghindari konflik ketergantungan yang tidak perlu bagi pengguna yang tidak membutuhkan fitur opsional.
Satu -satunya ketergantungan yang diperlukan adalah httpx ~ = 0,27 untuk telegram.request.HTTPXRequest , backend jaringan default.
python-telegram-bot paling berguna bila digunakan bersama dengan perpustakaan tambahan. Untuk meminimalkan konflik ketergantungan, kami mencoba menjadi liberal dalam hal persyaratan versi pada dependensi (opsional). Di sisi lain, kita harus memastikan stabilitas python-telegram-bot , itulah sebabnya kami menerapkan batas versi. Jika Anda menghadapi konflik ketergantungan karena batas -batas ini, jangan ragu untuk menjangkau.
PTB dapat diinstal dengan dependensi opsional:
pip install "python-telegram-bot[passport]" menginstal kriptografi> = 39.0.1 Perpustakaan. Gunakan ini, jika Anda ingin menggunakan fungsionalitas terkait paspor telegram.pip install "python-telegram-bot[socks]" menginstal httpx [SOCKS]. Gunakan ini, jika Anda ingin bekerja di belakang server Socks5.pip install "python-telegram-bot[http2]" menginstal httpx [http2]. Gunakan ini, jika Anda ingin menggunakan HTTP/2.pip install "python-telegram-bot[rate-limiter]" menginstal aiolimiter ~ = 1.1.0. Gunakan ini, jika Anda ingin menggunakan telegram.ext.AIORateLimiter .pip install "python-telegram-bot[webhooks]" menginstal tornado ~ = 6.4 Perpustakaan. Gunakan ini, jika Anda ingin menggunakan telegram.ext.Updater.start_webhook / telegram.ext.Application.run_webhook .pip install "python-telegram-bot[callback-data]" menginstal Cachetools> = 5.3.3, <5.6.0 Perpustakaan. Gunakan ini, jika Anda ingin menggunakan callback_data sewenang -wenang.pip install "python-telegram-bot[job-queue]" menginstal APSCHEDuler ~ = 3.10.4 PERPUSTAKAAN DAN PENDAFTARAN PYTZ> = 2018.6, di mana pytz merupakan ketergantungan APScheduler . Gunakan ini, jika Anda ingin menggunakan telegram.ext.JobQueue . Untuk menginstal beberapa dependensi opsional, pisahkan dengan koma, misalnya pip install "python-telegram-bot[socks,webhooks]" .
Selain itu, dua pintasan disediakan:
pip install "python-telegram-bot[all]" menginstal semua dependensi opsional.pip install "python-telegram-bot[ext]" menginstal semua dependensi opsional yang terkait dengan telegram.ext , yaitu [rate-limiter, webhooks, callback-data, job-queue] . Setelah Anda menginstal perpustakaan, Anda dapat mulai bekerja dengannya - jadi mari kita mulai!
Wiki kami berisi pengantar API yang menjelaskan bagaimana API bot murni dapat diakses melalui python-telegram-bot . Selain itu, tutorial: bot pertama Anda memberikan pengantar tentang bagaimana chatbots dapat dengan mudah diprogram dengan bantuan modul telegram.ext .
python-telegram-bot . Ini berisi deskripsi dari semua kelas, modul, metode, dan argumen yang tersedia serta changelog.python-telegram-bot dan sumber daya berguna lainnya yang melampaui dokumentasi teknis.python-telegram-bot . Bahkan jika itu bukan pendekatan Anda untuk belajar, silakan lihat echobot.py . Ini adalah basis de facto untuk sebagian besar bot di luar sana. Kode untuk contoh -contoh ini dirilis ke domain publik, sehingga Anda dapat mulai dengan mengambil kode dan membangun di atasnya.Jika sumber daya yang disebutkan di atas tidak menjawab pertanyaan Anda atau hanya membanjiri Anda, ada beberapa cara untuk mendapatkan bantuan.
Karena V20.0, python-telegram-bot dibangun di atas Modul Pythons asyncio . Karena asyncio secara umum adalah single-threaded, python-telegram-bot saat ini tidak bertujuan untuk aman. Bagian penting dari API python-telegram-bots yang cenderung menyebabkan masalah (misalnya kondisi balapan) ketika digunakan dalam pengaturan multi-threaded meliputi:
telegram.ext.Application/Updater.update_queuetelegram.ext.ConversationHandler.check/handle_updatetelegram.ext.CallbackDataCachetelegram.ext.BasePersistencetelegram.ext.filters yang memungkinkan untuk menambah/menghapus pengguna/obrolan yang diizinkan saat runtime Kontribusi semua ukuran dipersilakan. Harap tinjau pedoman kontribusi kami untuk memulai. Anda juga dapat membantu dengan melaporkan bug atau permintaan fitur.
Kadang -kadang kami ditanya apakah kami menerima sumbangan untuk mendukung pengembangan. Meskipun kami menghargai pemikiran itu, mempertahankan PTB adalah hobi kami, dan kami hampir tidak memiliki biaya operasional untuk itu. Karena itu kami tidak memiliki apa pun yang diatur untuk menerima sumbangan. Jika Anda masih ingin menyumbang, kami dengan ramah meminta Anda untuk menyumbang ke proyek/inisiatif open source pilihan Anda sebagai gantinya.
Anda dapat menyalin, mendistribusikan, dan memodifikasi perangkat lunak asalkan modifikasi dijelaskan dan dilisensikan secara gratis di bawah LGPL-3. Pekerjaan turunan (termasuk modifikasi atau apa pun yang secara statis terkait dengan perpustakaan) hanya dapat didistribusikan kembali di bawah LGPL-3, tetapi aplikasi yang menggunakan perpustakaan tidak harus.
