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← ко всем файлам