pyroitaly 1.0.1

Faster, lighter, and cleaner alternative to Pyrogram / Pyroitaly. Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots

PyroItaly

PyroItaly هي مكتبة واجهة برمجة تطبيقات MTProto لـ Telegram مكتوبة بلغة Python، وهي نسخة محسنة ومعاد تسميتها من pyrogram.

الميزات

• أداء محسن: استخدام uvloop وorjson وتقنيات النسخ الصفري لتحسين الأداء
• استقرار أفضل: معالجة أفضل للأخطاء وإعادة الاتصال التلقائي
• تجربة مطور محسنة: توثيق شامل وتعليقات نمطية ونظام تسجيل متطور
• نظام البرامج المساعدة: دعم للبرامج المساعدة مع hooks/events
• أدوات إدارة الجلسات: تصدير واستيراد الجلسات بسهولة
• أوامر مفيدة: أوامر مدمجة مثل /ping و/status و/debug

التثبيت

pip install pyroitaly

للحصول على أداء أفضل، قم بتثبيت الإضافات الاختيارية:

pip install "pyroitaly[speedup]"

مثال سريع

بوت تيليجرام

from pyroitaly import Client, filters

app = Client(
    "my_bot",
    api_id=12345,
    api_hash="0123456789abcdef0123456789abcdef",
    bot_token="123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
)

@app.on_message(filters.command("start"))
async def start_command(client, message):
    await message.reply_text(f"مرحباً {message.from_user.mention}!")

app.run()

مستخدم عادي (Userbot)

from pyroitaly import Client, filters

app = Client(
    "my_account",
    api_id=12345,
    api_hash="0123456789abcdef0123456789abcdef"
)

@app.on_message(filters.command("ping", prefixes=".") & filters.me)
async def ping_command(client, message):
    await message.edit_text("Pong!")

app.run()

استخدام نظام البرامج المساعدة

from pyroitaly import Client
from pyroitaly.plugins import PluginSystem

app = Client("my_bot")
plugin_system = PluginSystem(app)

# تسجيل برنامج مساعد
plugin = plugin_system.register_plugin(
    name="my_plugin",
    version="1.0.1",
    description="برنامج مساعد للتجربة",
    author="PyroItaly"
)

# تسجيل أمر
@plugin_system.register_command("my_plugin", "hello", description="يقول مرحباً")
async def hello_command(client, message):
    await message.reply_text("مرحباً بك!")

# تسجيل hook
@plugin_system.register_hook("bot_start")
async def on_bot_start():
    print("تم تشغيل البوت!")

app.run()

استخدام إعادة الاتصال التلقائي

from pyroitaly import Client
from pyroitaly.plugins import AutoReconnect

app = Client("my_bot")
auto_reconnect = AutoReconnect(app)

async def main():
    await app.start()
    await auto_reconnect.start()
    
    # البوت سيعيد الاتصال تلقائياً عند انقطاع الاتصال
    
    await app.idle()

app.run(main())

إدارة الجلسات

from pyroitaly import Client
from pyroitaly.plugins import SessionManager

async def export_session():
    app = Client("my_account")
    await app.start()
    
    # تصدير الجلسة
    session_str = await SessionManager.export_session(app)
    print(f"جلستك: {session_str}")
    
    # تصدير الجلسة مع كلمة مرور
    encrypted_session = await SessionManager.export_session(app, password="my_password")
    print(f"جلستك المشفرة: {encrypted_session}")
    
    await app.stop()

async def import_session(session_str):
    app = Client("imported_session")
    
    # استيراد الجلسة
    await SessionManager.import_session(app, session_str)
    
    await app.start()
    me = await app.get_me()
    print(f"تم تسجيل الدخول كـ {me.first_name}")
    await app.stop()

المساهمة

المساهمات مرحب بها! يرجى اتباع هذه الخطوات:

1. قم بعمل fork للمستودع
2. قم بإنشاء فرع للميزة الخاصة بك (git checkout -b feature/amazing-feature)
3. قم بعمل commit للتغييرات (git commit -m 'إضافة ميزة رائعة')
4. قم بدفع الفرع (git push origin feature/amazing-feature)
5. قم بفتح طلب سحب

الترخيص

هذا المشروع مرخص بموجب ترخيص GNU Lesser General Public License v3.0 - انظر ملف LICENSE للحصول على التفاصيل.

شكر وتقدير

• Dan - مؤلف Pyrogram الأصلي
• ItalyMusic - مؤلف PyroItaly