main module

בוט שומר קבצי קוד - Code Keeper Bot נקודת הכניסה הראשית לבוט

main.get_admin_ids()

Return type:

list[int]

async main.notify_admins(context, text)

Return type:

None

פרמטרים:

• context (telegram.ext.ContextTypes.DEFAULT_TYPE)

• text (str)

async main.log_user_activity(update, context)

רישום פעילות משתמש במערכת.

פרמטרים:

• update (Update) – אובייקט Update מטלגרם

• context (DEFAULT_TYPE) – הקונטקסט של השיחה

הערה

פונקציה זו נקראת אוטומטית עבור כל פעולה של משתמש

main.get_lock_collection()

מחזיר את קולקציית הנעילות ממסד הנתונים.

Returns:

קולקציית הנעילות

Return type:

pymongo.collection.Collection

Raises:

SystemExit – אם מסד הנתונים לא אותחל כראוי

הערה

משתמש במסד הנתונים שכבר נבחר ב-DatabaseManager

main.ensure_lock_indexes()

יוצר אינדקס TTL על שדה expires_at לניקוי אוטומטי של נעילות ישנות. :rtype: None

הערה

אם יצירת האינדקס נכשלת, המערכת תמשיך לעבוד ללא TTL אוטומטי

Return type:

None

main.cleanup_mongo_lock()

מנקה את נעילת MongoDB בעת יציאה מהתוכנית.

הערה

פונקציה זו נרשמת עם atexit ורצה אוטומטית בסיום התוכנית

main.manage_mongo_lock()

רוכש נעילה מבוזרת ב-MongoDB כדי להבטיח שרק מופע אחד של הבוט רץ.

Returns:

True אם הנעילה נרכשה בהצלחה, False אחרת

Return type:

bool

הערה

תומך בהמתנה לשחרור נעילה קיימת עבור blue/green deployments

class main.CodeKeeperBot

Bases: object

המחלקה הראשית של Code Keeper Bot.

מחלקה זו מנהלת את כל הפונקציונליות של הבוט, כולל: - הגדרת handlers לפקודות ומסרים - ניהול שיחות מורכבות - אינטגרציות עם שירותים חיצוניים - ניהול מסד נתונים

application

אובייקט Application של python-telegram-bot

github_handler

מנהל אינטגרציית GitHub

backup_handler

מנהל מערכת הגיבויים

__init__()

setup_handlers()

הגדרת כל ה-handlers של הבוט בסדר הנכון

async help_command(update, context)

פקודת עזרה מפורטת

פרמטרים:

• update (telegram.Update)

• context (telegram.ext.ContextTypes.DEFAULT_TYPE)

async save_command(update, context)

פקודת שמירת קוד

פרמטרים:

• update (telegram.Update)

• context (telegram.ext.ContextTypes.DEFAULT_TYPE)

async list_command(update, context)

הצגת רשימת הקטעים של המשתמש

פרמטרים:

• update (telegram.Update)

• context (telegram.ext.ContextTypes.DEFAULT_TYPE)

async search_command(update, context)

חיפוש קטעי קוד

פרמטרים:

• update (telegram.Update)

• context (telegram.ext.ContextTypes.DEFAULT_TYPE)

async check_commands(update, context)

בדיקת הפקודות הזמינות (רק לאמיר)

פרמטרים:

• update (telegram.Update)

• context (telegram.ext.ContextTypes.DEFAULT_TYPE)

async stats_command(update, context)

הצגת סטטיסטיקות המשתמש או מנהל

פרמטרים:

• update (telegram.Update)

• context (telegram.ext.ContextTypes.DEFAULT_TYPE)

async handle_document(update, context)

טיפול בקבצים שנשלחים לבוט

פרמטרים:

• update (telegram.Update)

• context (telegram.ext.ContextTypes.DEFAULT_TYPE)

async handle_text_message(update, context)

טיפול בהודעות טקסט (קוד פוטנציאלי)

פרמטרים:

• update (telegram.Update)

• context (telegram.ext.ContextTypes.DEFAULT_TYPE)

async error_handler(update, context)

טיפול בשגיאות

פרמטרים:

• update (object)

• context (telegram.ext.ContextTypes.DEFAULT_TYPE)

async start()

הפעלת הבוט

async stop()

עצירת הבוט

main.signal_handler(signum, frame)

טיפול בסיגנלי עצירה

main.setup_handlers(application, db_manager)

Register basic command handlers required for the bot to operate.

פרמטרים:

application (telegram.ext.Application)

main.main()

Initializes and runs the bot after acquiring a lock.

Return type:

None

async main.setup_bot_data(application)

A post_init function to setup application-wide data.

Return type:

None

פרמטרים:

application (telegram.ext.Application)