opencode-db 0.7.0__py3-none-any.whl → 0.7.2__py3-none-any.whl

cli.py

@@ -7,14 +7,20 @@
   - Единообразный интерфейс
 """
 
+from __future__ import annotations
+
 import argparse
 import os
 import sys
 from typing import Any, Literal
 
-import commands
-from db import get_db
-from i18n import _, set_lang
+from runtime import require_python
+
+require_python()
+
+import commands  # noqa: E402
+from db import get_db  # noqa: E402
+from i18n import _, set_lang  # noqa: E402
 
 
 def build_parser() -> argparse.ArgumentParser:

{opencode_db-0.7.0.dist-info → opencode_db-0.7.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencode-db
-Version: 0.7.0
+Version: 0.7.2
 Summary: OpenCode database CLI manager — browse, export, analyze, clean up sessions
 Project-URL: Homepage, https://github.com/VasilevNStas/opencode-db
 Project-URL: Source, https://github.com/VasilevNStas/opencode-db
@@ -23,6 +23,9 @@ Dynamic: license-file
 
 ```bash
 pip install opencode-db
+
+# recommended if your system python3 is older than 3.12:
+uv tool install opencode-db
 ```
 
 ## Quick start
@@ -54,6 +57,6 @@ pip install opencode-db         # zero external dependencies
 
 ## Requirements
 
-- Python 3.12+
+- Python 3.12+ — the CLI checks the interpreter at startup and exits with a clear message instead of an `ImportError` on older versions
 - [OpenCode](https://opencode.ai) (must have been run at least once)
 - macOS / Linux

{opencode_db-0.7.0.dist-info → opencode_db-0.7.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-cli.py,sha256=NFOmI4lcoiDmJTC2c1YqmZ02IRbNdhrmIYUd6Y25aOY,2296
+cli.py,sha256=H-7TFu17dqAQv_bUvQsw0Tuly57Je53WzKs6yQOjajk,2428
 cmd_costs.py,sha256=LstYavRJp-ZwwianBjRGtB8XiEKByGwMf6XwOHDHZvU,6395
 cmd_delete.py,sha256=VJyaWcxr3UVIGqkZrlXs4IOkHzySbc9dt0W6sAL5IIo,11282
 cmd_export.py,sha256=OfnNE1J9z7qbGbPqp1TXYIUBZZCEcUefkJcL1qlMdRw,6627
@@ -18,11 +18,12 @@ db.py,sha256=5NlNM9m_g2frj0oNVgJ9IIEf5oK2n6rbJqDycoVC_Mo,11914
 formatters.py,sha256=ovgtaB-gZFTCtrYl5dPWLKDUL8zG-Zl5nVHxFj2nJY4,7768
 i18n.py,sha256=7QHCc7-KcGfzA7odkesFpqfbi9XKuZ5fXZ2OTFazF68,36667
 markdown_to_ansi.py,sha256=HSr_yOZ1t1tYz5Z0Bx3yRqKzKSWxJIcuS02EKMO1WtE,6181
-utils.py,sha256=W5BrLO3s-ck0UFVJLAERlXHF6ck6iXQrf-wRmLxUe6c,4849
+runtime.py,sha256=BbKIOdGkrcgckMvOqJgfiEpp6vDAfwO0aI-uaC4-F_M,2155
+utils.py,sha256=c7RqEuxbx340RzJ1kzG14ucuf88aUzuc2gbKYb4919E,4849
 commands/__init__.py,sha256=0VZs89RtmsPYGkmgedKxPKaNtIgkMdx6HYHWHsuKCtE,1290
-opencode_db-0.7.0.dist-info/licenses/LICENSE,sha256=NhUr8ufTYb5u9F08J5bmDQ0xTVmCOexoq1ki_RdCqys,1210
-opencode_db-0.7.0.dist-info/METADATA,sha256=yarIoKVOaRcfp_Xk0yNBrJjur-CAbxKWwUfmiEfccmc,2302
-opencode_db-0.7.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-opencode_db-0.7.0.dist-info/entry_points.txt,sha256=dMHc-RWkGEu0mTNvHHThSEKQdGbCdwdKUCO-cLF7TCw,41
-opencode_db-0.7.0.dist-info/top_level.txt,sha256=rfyZ4RpmxOeSt4zcQ_ycvFMbBJpt1_WPuBFSnoRTSG4,204
-opencode_db-0.7.0.dist-info/RECORD,,
+opencode_db-0.7.2.dist-info/licenses/LICENSE,sha256=NhUr8ufTYb5u9F08J5bmDQ0xTVmCOexoq1ki_RdCqys,1210
+opencode_db-0.7.2.dist-info/METADATA,sha256=xB704HtWzrLTwEOtBrgPt_9BvP5Pzie1pXYpf1L5azk,2511
+opencode_db-0.7.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+opencode_db-0.7.2.dist-info/entry_points.txt,sha256=dMHc-RWkGEu0mTNvHHThSEKQdGbCdwdKUCO-cLF7TCw,41
+opencode_db-0.7.2.dist-info/top_level.txt,sha256=CnAP9fA7TDBA6mjuh2AWR2bo4ceTfTpxwLn-pe0Kcj4,212
+opencode_db-0.7.2.dist-info/RECORD,,

{opencode_db-0.7.0.dist-info → opencode_db-0.7.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (82.0.1)
+Generator: setuptools (84.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

{opencode_db-0.7.0.dist-info → opencode_db-0.7.2.dist-info}/top_level.txt

@@ -19,4 +19,5 @@ db
 formatters
 i18n
 markdown_to_ansi
+runtime
 utils

runtime.py

@@ -0,0 +1,55 @@
+"""Проверка минимальной версии Python.
+
+Модуль намеренно написан без синтаксиса новее Python 3.8, чтобы его можно
+было импортировать до проверки версии и показать понятную ошибку вместо
+ImportError/SyntaxError.
+"""
+
+import sys
+
+MIN_PYTHON = (3, 12)
+REQUIRED_VERSION = "3.12"
+
+
+def format_version_error(version_info=None, executable=None) -> str:
+    """Возвращает текст ошибки для неподдерживаемой версии Python."""
+    info = version_info or sys.version_info
+    exe = executable or sys.executable
+    current = f"{info[0]}.{info[1]}.{info[2]}"
+
+    return (
+        f"opencode-db requires Python {REQUIRED_VERSION}+.\n"
+        f"opencode-db требует Python {REQUIRED_VERSION}+.\n"
+        "\n"
+        f"Current interpreter: Python {current} ({exe})\n"
+        f"Текущий интерпретатор: Python {current} ({exe})\n"
+        "\n"
+        "How to fix / Как исправить:\n"
+        "  uv python install 3.13\n"
+        "  uv venv --python 3.13\n"
+        "  source .venv/bin/activate\n"
+        "  pip install -e .\n"
+        "\n"
+        "Or run with uv / Или запуск через uv:\n"
+        "  uv run --python 3.13 opencode-db --help\n"
+        "  uv tool install --editable . && opencode-db --help\n"
+        "\n"
+        "After changing the interpreter, rerun install.sh to regenerate\n"
+        "the ~/.local/bin/opencode-db launcher."
+    )
+
+
+def check_python_version(version_info=None):
+    """Возвращает None, если версия подходит, иначе текст ошибки."""
+    info = version_info or sys.version_info
+    if tuple(info[:2]) >= MIN_PYTHON:
+        return None
+    return format_version_error(info)
+
+
+def require_python() -> None:
+    """Завершает процесс с понятной ошибкой, если Python слишком старый."""
+    message = check_python_version()
+    if message:
+        print(message, file=sys.stderr)
+        raise SystemExit(1)

utils.py

@@ -50,7 +50,7 @@ def parse_date(date_str: str) -> datetime | None:
         return None
 
 
-def parse_time_spec(spec) -> None | datetime:
+def parse_time_spec(spec) -> datetime | None:
     """Парсит спецификацию времени ('30d', '6m', '1y') в timedelta."""
     if not spec or not isinstance(spec, str):
         return None