query.py

покрыто: 83 из 8498.8%
1"""Безопасное выполнение запросов: только чтение, лимит строк, лимит времени.23Песочница должна давать данные, но не давать испортить базу: соединение4открывается в режиме ``query_only``, разрешены только ``SELECT`` и ``WITH``,5результат обрезается по лимиту, а долгий запрос прерывается по дедлайну.6"""78from __future__ import annotations910import ast11import re12import sqlite313import time14from dataclasses import dataclass, field15from typing import Any1617READ_PREFIX = re.compile(r"^\s*(?:--[^\n]*\n\s*)*(select|with)\b", re.IGNORECASE)18DEFAULT_LIMIT = 20019MAX_LIMIT = 100020DEFAULT_TIMEOUT_MS = 150021PROGRESS_STEPS = 2000222324class QueryError(ValueError):25    """Запрос отклонён до выполнения."""262728@dataclass29class QueryResult:30    sql: str31    columns: list[str] = field(default_factory=list)32    rows: list[dict[str, Any]] = field(default_factory=list)33    rowcount: int = 034    duration_ms: float = 0.035    truncated: bool = False36    error: str | None = None3738    @property39    def ok(self) -> bool:40        return self.error is None4142    def as_dict(self) -> dict:43        return {44            "ok": self.ok,45            "sql": self.sql,46            "columns": self.columns,47            "rows": self.rows,48            "rowcount": self.rowcount,49            "duration_ms": round(self.duration_ms, 2),50            "truncated": self.truncated,51            "error": self.error,52        }535455def _strip_sql_comments(sql: str) -> str:56    without_block = re.sub(r"/\*.*?\*/", " ", sql, flags=re.DOTALL)57    return re.sub(r"--[^\n]*", " ", without_block)585960def _has_several_statements(sql: str) -> bool:61    cleaned = sql.strip().rstrip(";")62    return ";" in cleaned636465def validate(sql: str) -> str:66    text = (sql or "").strip()67    if not text:68        raise QueryError("запрос пустой")69    stripped = _strip_sql_comments(text).strip()70    if not READ_PREFIX.match(stripped):71        raise QueryError("разрешены только запросы SELECT и WITH")72    if _has_several_statements(stripped):73        raise QueryError("разрешён только один запрос за раз")74    return text.rstrip(";").strip()757677def _is_sql_literal(value: str) -> bool:78    return bool(re.match(r"^\s*(select|with)\b", value, re.IGNORECASE))798081def extract_sql(code: str) -> str | None:82    """Достаёт последний SQL-литерал из кода — так удобно «выполнить то, что в функции».8384    Куски f-строк (``JoinedStr``) не считаются запросом: склеенная строка не85    гарантирует корректный SQL и не должна уходить в песочницу.86    """87    tree = None88    try:89        tree = ast.parse(code)90    except SyntaxError:91        tree = None92    inside_fstring: set[int] = set()93    for node in ast.walk(tree) if tree is not None else []:94        if isinstance(node, ast.JoinedStr):95            inside_fstring.update(id(child) for child in ast.walk(node))96    found = [97        node.value98        for node in (ast.walk(tree) if tree is not None else [])99        if isinstance(node, ast.Constant)100        and isinstance(node.value, str)101        and id(node) not in inside_fstring102        and _is_sql_literal(node.value)103    ]104    return found[-1] if found else None105106107def open_readonly(path: str) -> sqlite3.Connection:108    connection = sqlite3.connect(path, check_same_thread=False)109    connection.row_factory = sqlite3.Row110    connection.execute("PRAGMA query_only = ON")111    return connection112113114def run_query(115    connection: sqlite3.Connection,116    sql: str,117    limit: int = DEFAULT_LIMIT,118    timeout_ms: int = DEFAULT_TIMEOUT_MS,119) -> QueryResult:120    result = QueryResult(sql=sql)121    started = time.perf_counter()122    deadline = started + timeout_ms / 1000123    try:124        statement = validate(sql)125        rows = _fetch(connection, statement, limit, deadline)126        result.columns, result.rows, result.truncated = rows127        result.rowcount = len(result.rows)128    except (QueryError, sqlite3.Error) as exc:129        result.error = str(exc)130    finally:131        connection.set_progress_handler(None, 0)132        result.duration_ms = (time.perf_counter() - started) * 1000133    return result134135136def _fetch(137    connection: sqlite3.Connection,138    statement: str,139    limit: int,140    deadline: float,141) -> tuple[list[str], list[dict[str, Any]], bool]:142    capped = max(1, min(int(limit), MAX_LIMIT))143    connection.set_progress_handler(lambda: int(time.perf_counter() > deadline), PROGRESS_STEPS)144    cursor = connection.execute(statement)145    columns = [description[0] for description in cursor.description or ()]146    fetched = cursor.fetchmany(capped + 1)147    truncated = len(fetched) > capped148    rows = [dict(row) for row in fetched[:capped]]149    return columns, rows, truncated

← ко всем файлам