Services

תיעוד של שירותי הליבה של המערכת.

Code Service

Code Service Module

שירות עיבוד וניתוח קוד עבור Code Keeper Bot.

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

services.code_service.detect_language(code, filename)[מקור]

מקור אמת לזיהוי שפה: דטקטור דומייני. נשמרים fallback-ים ישנים לתאימות, אך החלטה סופית מגיעה מהדומיין כאשר אפשר.

Return type:

str

פרמטרים:
services.code_service.validate_code_input(code, file_name, user_id)[מקור]

בודק ומנקה קלט קוד.

פרמטרים:

  • code (str) – קוד המקור לבדיקה

  • file_name (str) – שם הקובץ

  • user_id (int) – מזהה המשתמש

Returns:

(is_valid, cleaned_code, error_message)

  • is_valid: האם הקוד תקין

  • cleaned_code: הקוד המנוקה

  • error_message: הודעת שגיאה (אם יש)

Return type:

Tuple[bool, str, str]

services.code_service.analyze_code(code, language)[מקור]

מבצע ניתוח על קטע קוד עבור שפה נתונה.

פרמטרים:

  • code (str) – קוד המקור לניתוח

  • language (str) – שפת התכנות

Returns:

מילון עם תוצאות הניתוח, כולל:

  • lines: מספר שורות

  • complexity: מורכבות הקוד

  • metrics: מטריקות נוספות

Return type:

Dict[str, Any]

services.code_service.extract_functions(code, language)[מקור]

Extract function definitions from code.

Return type:

List[Dict[str, Any]]

פרמטרים:
services.code_service.get_code_stats(code)[מקור]

Compute simple statistics for a code snippet.

Return type:

Dict[str, Any]

פרמטרים:

code (str)

services.code_service.highlight_code(code, language)[מקור]

Return syntax highlighted representation for code.

Return type:

str

פרמטרים:

GitHub Service

Backup Service

services.backup_service.save_backup_bytes(data, metadata)[מקור]
Return type:

bool

פרמטרים:
services.backup_service.list_backups(user_id)[מקור]
פרמטרים:

user_id (int)

services.backup_service.restore_from_backup(user_id, backup_path, overwrite=True, purge=True)[מקור]
Return type:

Dict[str, Any]

פרמטרים:
services.backup_service.delete_backups(user_id, backup_ids)[מקור]
Return type:

Dict[str, Any]

פרמטרים:

AI Explain Service

שירות observability שמפיק הסברים להתראות על בסיס Anthropic Claude עם fallback בין מודלים, סניטציה של לוגים וחיתוך שדות רגישים לפני שליחת ההקשר.

ראו גם 🧠 Observability AI Explain API.

Community Library Service

ניהול ספריית קוד קהילתית: קליטת מועמדים, אישור/דחייה מול MongoDB, רשימות פומביות עם חיפוש, תגיות וסימון Featured.

Image Generator Service

מחולל תמונות קוד מקצועיות עם Pygments, Playwright/WeasyPrint/PIL, מגוון תמות (dark/light/github/monokai וכו«) ותמיכה בבחירת פונטים.

שירות ליצירת תמונות קוד עם היילייטינג (Playwright → WeasyPrint → PIL).

Code Image Generator Service

מסלול מועדף:

  • Playwright (אם מותקן) – רינדור HTML בדפדפן headless באיכות גבוהה. Playwright רץ ב-subprocess נפרד כדי להימנע מקונפליקט עם gevent monkey patching.

  • WeasyPrint (אם מותקן) – רינדור HTML איכותי.

  • PIL fallback – ציור ידני עם סקייל x3 לשיפור חדות.

class services.image_generator.TechGuideStyle[מקור]

Bases: Style

ערכת הצבעים של Tech Guide: רקע כהה מאוד, צבעים חזקים וברורים לקוד.

default_style = ''
styles = {(): '', ('Comment',): '#6a9955 italic', ('Comment', 'Hashbang'): '', ('Comment', 'Multiline'): '', ('Comment', 'Preproc'): '', ('Comment', 'PreprocFile'): '', ('Comment', 'Single'): '', ('Comment', 'Special'): '', ('Error',): '#f44747', ('Escape',): '', ('Generic',): '', ('Generic', 'Deleted'): '', ('Generic', 'Emph'): '', ('Generic', 'EmphStrong'): '', ('Generic', 'Error'): '', ('Generic', 'Heading'): '#569cd6 bold', ('Generic', 'Inserted'): '', ('Generic', 'Output'): '', ('Generic', 'Prompt'): '', ('Generic', 'Strong'): '', ('Generic', 'Subheading'): '#569cd6 bold', ('Generic', 'Traceback'): '', ('Keyword',): '#569cd6', ('Keyword', 'Constant'): '', ('Keyword', 'Declaration'): '', ('Keyword', 'Namespace'): '', ('Keyword', 'Pseudo'): '', ('Keyword', 'Reserved'): '', ('Keyword', 'Type'): '#4ec9b0', ('Literal',): '', ('Literal', 'Date'): '', ('Literal', 'Number'): '#b5cea8', ('Literal', 'Number', 'Bin'): '', ('Literal', 'Number', 'Float'): '', ('Literal', 'Number', 'Hex'): '', ('Literal', 'Number', 'Integer'): '', ('Literal', 'Number', 'Integer', 'Long'): '', ('Literal', 'Number', 'Oct'): '', ('Literal', 'String'): '#ce9178', ('Literal', 'String', 'Affix'): '', ('Literal', 'String', 'Backtick'): '', ('Literal', 'String', 'Char'): '', ('Literal', 'String', 'Delimiter'): '', ('Literal', 'String', 'Doc'): '', ('Literal', 'String', 'Double'): '', ('Literal', 'String', 'Escape'): '', ('Literal', 'String', 'Heredoc'): '', ('Literal', 'String', 'Interpol'): '', ('Literal', 'String', 'Other'): '', ('Literal', 'String', 'Regex'): '', ('Literal', 'String', 'Single'): '', ('Literal', 'String', 'Symbol'): '', ('Name',): '#dcdcaa', ('Name', 'Attribute'): '', ('Name', 'Builtin'): '', ('Name', 'Builtin', 'Pseudo'): '', ('Name', 'Class'): '#4ec9b0 bold', ('Name', 'Constant'): '', ('Name', 'Decorator'): '', ('Name', 'Entity'): '', ('Name', 'Exception'): '', ('Name', 'Function'): '#dcdcaa', ('Name', 'Function', 'Magic'): '', ('Name', 'Label'): '', ('Name', 'Namespace'): '', ('Name', 'Other'): '', ('Name', 'Property'): '', ('Name', 'Tag'): '', ('Name', 'Variable'): '', ('Name', 'Variable', 'Class'): '', ('Name', 'Variable', 'Global'): '', ('Name', 'Variable', 'Instance'): '', ('Name', 'Variable', 'Magic'): '', ('Operator',): '#d4d4d4', ('Operator', 'Word'): '', ('Other',): '', ('Punctuation',): '', ('Punctuation', 'Marker'): '', ('Text',): '#d4d4d4', ('Text', 'Whitespace'): ''}

Style definitions for individual token types.

class services.image_generator.CodeImageGenerator(style='monokai', theme='dark', *, font_family=None)[מקור]

Bases: object

מחולל תמונות לקוד עם הדגשת תחביר.

מבוסס על PIL לציור טקסט ואזורי מספרי שורות, ועל Pygments ליצירת HTML מודגש שממנו מחולצים צבעים בסיסיים.

פרמטרים:

  • style (str)

  • theme (str)

  • font_family (Optional[str])

DEFAULT_WIDTH = 1200
DEFAULT_PADDING = 40
LINE_HEIGHT = 24
FONT_SIZE = 14
LINE_NUMBER_WIDTH = 60
LOGO_SIZE = (80, 20)
LOGO_PADDING = 10
CARD_MARGIN = 18
TITLE_BAR_HEIGHT = 28
CODE_GUTTER_SPACING = 20
THEMES = {'banner_tech': {'background': '#1d1a26', 'border': '#4b4363', 'line_number_bg': '#14121a', 'line_number_text': '#6e6290', 'text': '#d4d4d4', 'watermark': '#7cd827'}, 'dark': {'background': '#1e1e1e', 'border': '#3e3e42', 'line_number_bg': '#252526', 'line_number_text': '#858585', 'text': '#d4d4d4'}, 'dracula': {'background': '#282a36', 'border': '#44475a', 'line_number_bg': '#1e1f29', 'line_number_text': '#6272a4', 'text': '#f8f8f2'}, 'github': {'background': '#0d1117', 'border': '#30363d', 'line_number_bg': '#161b22', 'line_number_text': '#7d8590', 'text': '#c9d1d9'}, 'gruvbox': {'background': '#282828', 'border': '#504945', 'line_number_bg': '#3c3836', 'line_number_text': '#bdae93', 'text': '#ebdbb2'}, 'light': {'background': '#ffffff', 'border': '#e0e0e0', 'line_number_bg': '#f5f5f5', 'line_number_text': '#999999', 'text': '#333333'}, 'monokai': {'background': '#272822', 'border': '#49483e', 'line_number_bg': '#3e3d32', 'line_number_text': '#75715e', 'text': '#f8f8f2'}, 'one_dark': {'background': '#282c34', 'border': '#3b4048', 'line_number_bg': '#21252b', 'line_number_text': '#5c6370', 'text': '#abb2bf'}}
__init__(style='monokai', theme='dark', *, font_family=None)[מקור]
פרמטרים:

  • style (str)

  • theme (str)

  • font_family (str | None)

Return type:

None

cleanup()[מקור]

תאימות לאחור – אין צורך בפעולה לאחר מעבר ל-Async Playwright.

Return type:

None

configure(*, style=None, theme=None, font_family=None)[מקור]

עדכון דינמי של ההעדפות בלי יצירת מופע חדש.

Return type:

None

פרמטרים:

  • style (str | None)

  • theme (str | None)

  • font_family (str | None)

optimize_image_size(img)[מקור]
פרמטרים:

img (Image.Image)

Return type:

Image.Image

save_optimized_png(img)[מקור]

Always return PNG for crisp code images; keep optimization, avoid JPEG.

פרמטרים:

img (Image.Image)

Return type:

bytes

generate_image(code, language='text', filename=None, max_width=1200, max_height=None, note=None)[מקור]
Return type:

bytes

פרמטרים:

  • code (str)

  • language (str)

  • filename (str | None)

  • max_width (int)

  • max_height (int | None)

  • note (str | None)

Snippet Library Service

מנהל את ספריית הסניפטים המובנית: Built-in snippets, שליחת הצעות, אישור מנהלים, חיפוש לפי שפה/תגיות וסנכרון עם ה-Repo הקיים.

Observability HTTP Service

עטיפה ליצירת בקשות HTTP מאובטחות אל Grafana/Prometheus תוך מניעת SSRF, אימות DNS Rebinding ושימור Host header עבור SNI.

exception services.observability_http.SecurityError[מקור]

Bases: RuntimeError

Raised when an unsafe network request is detected.

services.observability_http.is_private_ip(ip)[מקור]

Return True if the IP address belongs to a private or unsafe range.

Return type:

bool

פרמטרים:

ip (str)

services.observability_http.resolve_and_validate_domain(domain)[מקור]

Resolve the given domain and verify that all IPs are public.

Return type:

Tuple[str, List[str]]

פרמטרים:

domain (str)

class services.observability_http.HostHeaderSSLAdapter(hostname, *args, **kwargs)[מקור]

Bases: HTTPAdapter

Adapter that preserves the original hostname for HTTPS + SNI.

פרמטרים:

hostname (str)

__init__(hostname, *args, **kwargs)[מקור]
פרמטרים:

hostname (str)

init_poolmanager(*args, **kwargs)[מקור]

Initializes a urllib3 PoolManager.

This method should not be called from user code, and is only exposed for use when subclassing the HTTPAdapter.

פרמטרים:

  • connections – The number of urllib3 connection pools to cache.

  • maxsize – The maximum number of connections to save in the pool.

  • block – Block when no free connections are available.

  • pool_kwargs – Extra keyword arguments used to initialize the Pool Manager.

proxy_manager_for(*args, **kwargs)[מקור]

Return urllib3 ProxyManager for the given proxy.

This method should not be called from user code, and is only exposed for use when subclassing the HTTPAdapter.

פרמטרים:

  • proxy – The proxy to return a urllib3 ProxyManager for.

  • proxy_kwargs – Extra keyword arguments used to configure the Proxy Manager.

Returns:

ProxyManager

Return type:

urllib3.ProxyManager

services.observability_http.fetch_url_securely(url, *, timeout=10, allow_redirects=False, headers=None)[מקור]

Fetch an already-built URL while protecting against SSRF/DNS rebinding.

Return type:

bytes

פרמטרים:
services.observability_http.fetch_graph_securely(graph_url_template, *, timeout=10, allow_redirects=False, headers=None, **url_params)[מקור]

Fetch a graph/JSON endpoint while protecting against DNS rebinding / SSRF.

פרמטרים:

  • graph_url_template (str) – URL template (format-style) from configuration.

  • timeout (int) – Request timeout in seconds.

  • allow_redirects (bool) – Whether to follow redirects (default False).

  • headers (Optional[Dict[str, str]]) – Optional base headers to attach to the request.

  • **url_params – Values used to render the template.

Return type:

bytes

Google Drive Service