opencode-db 0.6.2__tar.gz → 0.7.2__tar.gz

opencode_db-0.7.2/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: opencode-db
+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
+Project-URL: Tracker, https://github.com/VasilevNStas/opencode-db/issues
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: rich
+Requires-Dist: rich>=13.0; extra == "rich"
+Provides-Extra: all
+Requires-Dist: opencode-db[rich]; extra == "all"
+Dynamic: license-file
+
+# opencode-db
+
+[![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+**CLI for OpenCode's local database.** OpenCode saves every agent session, conversation, token usage, and cost in a local SQLite file. This tool lets you inspect, export, analyze, and clean up that data.
+
+```bash
+pip install opencode-db
+
+# recommended if your system python3 is older than 3.12:
+uv tool install opencode-db
+```
+
+## Quick start
+
+```bash
+opencode-db list         # recent sessions
+opencode-db view         # interactive session viewer (colored, scrollable)
+opencode-db stats        # database summary
+opencode-db costs --total  # total token costs
+opencode-db export       # export dialog to .md (interactive)
+opencode-db help         # full reference
+```
+
+## Features
+
+- **`view`** — просмотр сессии в терминале с ANSI-цветами, Markdown-рендерингом и прокруткой через `less`
+- **`list`** / **`info`** / **`search`** / **`tree`** — навигация и поиск по сессиям
+- **`export`** — экспорт диалога в Markdown (с поддержкой Obsidian)
+- **`delete`** / **`prune`** — удаление и массовая очистка с фильтрами
+- **`costs`** / **`stats`** — аналитика токенов и расходов
+- **`--db-path`** / **`OPENCODE_DB`** — кастомный путь к БД
+
+## Optional extras
+
+```bash
+pip install opencode-db[rich]   # enhanced Markdown rendering (recommended)
+pip install opencode-db         # zero external dependencies
+```
+
+## Requirements
+
+- 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.6.2 → opencode_db-0.7.2}/README.md

@@ -22,9 +22,10 @@ opencode-db costs --total  # total token costs
 
 ### Requirements
 
-- Python 3.12+
+- Python 3.12+ — `opencode-db` refuses to start on older interpreters with a clear message (no cryptic `ImportError`)
 - OpenCode (must have been run at least once — the database is created automatically)
 - macOS / Linux
+- [`uv`](https://docs.astral.sh/uv/) — optional, but recommended for installing and running on systems whose default `python3` is older than 3.12
 
 ### Database location
 
@@ -51,13 +52,26 @@ opencode-db --db-path /path/to/opencode.db stats
 
 The `--db-path` flag takes precedence over the environment variable.
 
-### One-command install (recommended)
+### Recommended: uv
+
+If your system `python3` is older than 3.12 (for example, macOS ships 3.9), use `uv` — it installs the tool into an isolated environment with a supported interpreter:
+
+```bash
+uv tool install opencode-db
+# with enhanced Markdown rendering:
+uv tool install "opencode-db[rich]"
+
+# one-off run without installing:
+uvx opencode-db stats
+```
+
+### One-command install
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/VasilevNStas/opencode-db/master/install.sh | sh
 ```
 
-Downloads everything to `~/.local/share/opencode-db/` and creates `~/.local/bin/opencode-db`.
+Downloads everything to `~/.local/share/opencode-db/` and creates `~/.local/bin/opencode-db`. The installer looks for Python 3.12+ (including interpreters managed by `uv` or `pyenv`) and writes the discovered path into the launcher shebang.
 
 ### pip / pipx install
 
@@ -67,7 +81,7 @@ pipx install opencode-db
 pip install opencode-db
 ```
 
-[Zero external dependencies](https://treyhunner.com/2015/12/python-imports-and-path-manipulation/) — pure Python standard library only.
+[Zero external dependencies](https://treyhunner.com/2015/12/python-imports-and-path-manipulation/) — pure Python standard library only (`rich` is optional).
 
 ### Manual install
 
@@ -82,7 +96,17 @@ git clone https://github.com/VasilevNStas/opencode-db.git ~/.local/share/opencod
 ```bash
 cat > ~/.local/bin/opencode-db << 'SCRIPT'
 #!/usr/bin/env python3
-import sys, os
+import os
+import sys
+
+if sys.version_info < (3, 12):
+    print(
+        "opencode-db requires Python 3.12+; current: %s (%s)"
+        % (".".join(map(str, sys.version_info[:3])), sys.executable),
+        file=sys.stderr,
+    )
+    raise SystemExit(1)
+
 PKG_DIR = os.path.expanduser("~/.local/share/opencode-db")
 if PKG_DIR not in sys.path:
     sys.path.insert(0, PKG_DIR)
@@ -488,14 +512,16 @@ Example output:
 ~/.local/share/opencode-db/               ← all source code
 │
 ├── __init__.py                           ← executable entry point
-├── __main__.py                           ← python -m opencode_db
+├── __main__.py                           ← python3 . (directory entry point)
 ├── cli.py                                ← argparse + command dispatcher
 │
 ├── config.py                             ← constants and paths
+├── runtime.py                            ← Python 3.12+ version guard
 ├── db.py                                 ← SQLite queries
 ├── utils.py                              ← date/token formatting, validation
 ├── formatters.py                         ← tables, JSON, Markdown, snapshots
-├── i18n.py                               ← localization (EN/RU, 238 keys)
+├── i18n.py                               ← localization (EN/RU, 280 keys)
+├── markdown_to_ansi.py                   ← Markdown → ANSI renderer for `view`
 │
 ├── commands/
 │   └── __init__.py                       ← command registry
@@ -512,6 +538,7 @@ Example output:
 ├── cmd_stats.py                          ← opencode-db stats
 ├── cmd_todos.py                          ← opencode-db todos
 ├── cmd_vacuum.py                         ← opencode-db vacuum
+├── cmd_view.py                           ← opencode-db view
 └── cmd_help.py                           ← opencode-db help
 
 README.md                                 ← this file (English)
@@ -522,10 +549,11 @@ opencode-db-commands.json                 ← OpenCode TUI custom commands confi
 ### How it works
 
 1. The launcher script at `~/.local/bin/opencode-db` (a shebang Python script) adds `~/.local/share/opencode-db/` to `sys.path` and calls `cli.main()`.
-2. `cli.py` builds an `argparse` parser with subparsers from every command module and dispatches the call.
-3. Each command is a separate `cmd_*.py` module exporting two functions: `register(subparsers)` and `run(args, db)`.
-4. `db.py` opens a connection to OpenCode's SQLite database (`~/.local/share/opencode/opencode.db`).
-5. Destructive operations (`delete`, `prune`) always require confirmation (or `--force`).
+2. `runtime.require_python()` checks the interpreter before importing `cli`/`db`; on Python < 3.12 it prints a clear message with remediation steps instead of failing with `ImportError`.
+3. `cli.py` builds an `argparse` parser with subparsers from every command module and dispatches the call.
+4. Each command is a separate `cmd_*.py` module exporting two functions: `register(subparsers)` and `run(args, db)`.
+5. `db.py` opens a connection to OpenCode's SQLite database (`~/.local/share/opencode/opencode.db`).
+6. Destructive operations (`delete`, `prune`) always require confirmation (or `--force`).
 
 ### Database schema (key tables)
 
@@ -617,7 +645,7 @@ opencode-db --lang en help        # English help text
 opencode-db --lang en stats       # English statistics
 ```
 
-The `--lang` flag applies to any command. All 238 UI strings are translated. Data content (session titles, project names, etc.) remains in its original language.
+The `--lang` flag applies to any command. All 280 UI strings are translated. Data content (session titles, project names, etc.) remains in its original language.
 
 The language can also be set via environment variable `OPENCODE_DB_LANG=en`.
 
@@ -659,10 +687,54 @@ Use a longer prefix or the full session ID (use `list --json` to find it).
 
 If the database is being used by another process (e.g., OpenCode is running), VACUUM may fail. Close OpenCode and try again.
 
+### `ImportError: cannot import name 'UTC' from 'datetime'`
+
+This means `opencode-db` is running on Python older than 3.12 (for example, the system Python 3.9). Check:
+
+```bash
+python3 --version
+```
+
+Fix with `uv` (recommended):
+
+```bash
+uv python install 3.13
+uv tool install opencode-db
+opencode-db stats
+```
+
+Or run the repository checkout with an explicit interpreter:
+
+```bash
+uvx --from . opencode-db stats
+# alternative for a persistent dev environment:
+uv run --python 3.13 opencode-db stats
+```
+
+After changing the interpreter, rerun `install.sh` to regenerate the `~/.local/bin/opencode-db` launcher.
+
 ---
 
 ## Development
 
+### Local development
+
+Requires Python 3.12+ and `pytest`/`ruff`:
+
+```bash
+git clone https://github.com/VasilevNStas/opencode-db.git
+cd opencode-db
+
+uv venv --python 3.13
+source .venv/bin/activate
+uv pip install -e ".[rich]"
+uv pip install pytest ruff
+
+make check          # check-python + ruff + 191 tests
+```
+
+`make check` fails fast with a clear message if the active interpreter is older than 3.12.
+
 ### Adding a new command
 
 1. Create `cmd_xxx.py`:
@@ -692,10 +764,11 @@ The command will appear in `--help` automatically.
 python3 ~/.local/share/opencode-db list
 ```
 
-Or as a module:
+Or from the repository root (Python 3.12+):
 
 ```bash
-python3 -m opencode_db list
+python3 . list
+uvx --from . opencode-db list
 ```
 
 ---

opencode_db-0.7.2/README_PYPI.md

@@ -0,0 +1,46 @@
+# opencode-db
+
+[![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+**CLI for OpenCode's local database.** OpenCode saves every agent session, conversation, token usage, and cost in a local SQLite file. This tool lets you inspect, export, analyze, and clean up that data.
+
+```bash
+pip install opencode-db
+
+# recommended if your system python3 is older than 3.12:
+uv tool install opencode-db
+```
+
+## Quick start
+
+```bash
+opencode-db list         # recent sessions
+opencode-db view         # interactive session viewer (colored, scrollable)
+opencode-db stats        # database summary
+opencode-db costs --total  # total token costs
+opencode-db export       # export dialog to .md (interactive)
+opencode-db help         # full reference
+```
+
+## Features
+
+- **`view`** — просмотр сессии в терминале с ANSI-цветами, Markdown-рендерингом и прокруткой через `less`
+- **`list`** / **`info`** / **`search`** / **`tree`** — навигация и поиск по сессиям
+- **`export`** — экспорт диалога в Markdown (с поддержкой Obsidian)
+- **`delete`** / **`prune`** — удаление и массовая очистка с фильтрами
+- **`costs`** / **`stats`** — аналитика токенов и расходов
+- **`--db-path`** / **`OPENCODE_DB`** — кастомный путь к БД
+
+## Optional extras
+
+```bash
+pip install opencode-db[rich]   # enhanced Markdown rendering (recommended)
+pip install opencode-db         # zero external dependencies
+```
+
+## Requirements
+
+- 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.6.2 → opencode_db-0.7.2}/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.2/cmd_view.py

@@ -0,0 +1,363 @@
+"""Command view: просмотр сессии в терминале с прокруткой.
+
+Выводит отформатированный диалог с ANSI-цветами,
+автоматически использует $PAGER (less -R) для прокрутки.
+
+Режимы выбора сессии:
+  - view <session_id>          — по ID (полный или префикс)
+  - view --latest              — самая свежая сессия
+  - view (без аргументов)      — интерактивный выбор из списка
+"""
+
+import argparse
+import os
+import shutil
+import subprocess
+import sys
+
+from db import (
+    SessionError,
+    get_latest_session,
+    get_messages,
+    get_project_name,
+    get_recent_sessions,
+    get_session_info,
+    get_session_title,
+    parse_model,
+)
+from i18n import _
+from markdown_to_ansi import render as md_render
+from utils import build_help_epilog, format_cost, format_tokens, format_ts
+
+_VIEW_EXAMPLES = [
+    ("<session_id>", "help.view.e0"),
+    ("--latest", "help.view.e1"),
+    ("", "help.view.e2"),
+    ("--no-pager", "help.view.e3"),
+    ("--raw", "help.view.e4"),
+]
+
+
+def register(subparsers) -> None:
+    p = subparsers.add_parser(
+        "view",
+        help=_("help.cmd.view"),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=build_help_epilog("view", _VIEW_EXAMPLES),
+    )
+    p.add_argument(
+        "session_id",
+        nargs="?",
+        help="Session ID (optional — interactive mode if omitted)",
+    )
+    p.add_argument("--latest", "-l", action="store_true", help=_("view.flag.latest"))
+    p.add_argument("--no-pager", "-P", action="store_true", help=_("view.flag.no_pager"))
+    p.add_argument("--raw", "-R", action="store_true", help=_("view.flag.raw"))
+
+
+def run(args, db) -> int:
+    if args.session_id:
+        return _view_by_id(db, args.session_id, args.no_pager, args.raw)
+    if args.latest:
+        return _view_latest(db, args.no_pager, args.raw)
+    return _view_interactive(db, args.no_pager, args.raw)
+
+
+# ======================================================================
+# Selection modes
+# ======================================================================
+
+
+def _view_by_id(db, session_id, no_pager, raw) -> int:
+    try:
+        info = get_session_info(db, session_id)
+    except SessionError as e:
+        print(e.message)
+        return 1
+    return _do_view(db, info, no_pager, raw)
+
+
+def _view_latest(db, no_pager, raw) -> int:
+    try:
+        session_id = get_latest_session(db)
+        info = get_session_info(db, session_id)
+    except SessionError as e:
+        print(e.message)
+        return 1
+    title = get_session_title(info)
+    print(_("session.latest", title=title))
+    return _do_view(db, info, no_pager, raw)
+
+
+def _view_interactive(db, no_pager, raw) -> int:
+    sessions = get_recent_sessions(db)
+    if not sessions:
+        print(_("view.no_sessions"))
+        return 1
+
+    print()
+    print(f"  {'─' * 60}")
+    print(f"  {_('view.interactive_header')}")
+    print(f"  {'─' * 60}")
+
+    for i, s in enumerate(sessions, 1):
+        title = get_session_title(s)
+        created = format_ts(s["time_created"], "%Y-%m-%d %H:%M")
+        cost = format_cost(s["cost"])
+        print(f"  {i:2d}. {s['id'][:24]}  {created}  {title[:40]:40s}  {cost}")
+
+    print(f"  {'─' * 60}")
+
+    while True:
+        try:
+            choice = input("  " + _("view.interactive_prompt")).strip()
+        except (EOFError, KeyboardInterrupt):
+            print()
+            return 1
+
+        if not choice:
+            print(_("view.interactive_abort"))
+            return 1
+
+        try:
+            idx = int(choice) - 1
+            if 0 <= idx < len(sessions):
+                break
+        except ValueError:
+            pass
+
+        print(f"  {_('view.interactive_error', n=len(sessions))}")
+
+    session_id = sessions[idx]["id"]
+    title = get_session_title(sessions[idx])
+    print(_("view.interactive_viewing", title=title))
+    try:
+        info = get_session_info(db, session_id)
+    except SessionError as e:
+        print(e.message)
+        return 1
+    return _do_view(db, info, no_pager, raw)
+
+
+# ======================================================================
+# Display engine
+# ======================================================================
+
+
+def _init_styles(raw=False):
+    """Return style dict. Empty dict = no ANSI codes."""
+    if raw or not sys.stdout.isatty():
+        return {}
+    return {
+        "R": "\033[0m",
+        "B": "\033[1m",
+        "D": "\033[2m",
+        "G": "\033[32m",
+        "C": "\033[36m",
+        "Y": "\033[33m",
+        "M": "\033[90m",
+    }
+
+
+def _do_view(db, info, no_pager, raw) -> int:
+    sty = _init_styles(raw)
+    messages = get_messages(db, info["id"])
+    text = _format_session(db, info, messages, sty)
+
+    use_pager = not no_pager and sys.stdout.isatty() and len(text) > 1000
+    if use_pager:
+        _page_text(text)
+    else:
+        sys.stdout.write(text)
+        if not text.endswith("\n"):
+            sys.stdout.write("\n")
+        sys.stdout.flush()
+
+    return 0
+
+
+def _format_session(db, info, messages, sty) -> str:
+    """Build the full formatted session view string."""
+    title = get_session_title(info)
+    model = parse_model(info)
+    created = format_ts(info["time_created"])
+    msg_count = len(messages)
+
+    duration = "—"
+    if info["time_updated"] and info["time_created"]:
+        duration_sec = (info["time_updated"] - info["time_created"]) / 1000
+        if duration_sec < 60:
+            duration = _("info.dur_sec", n=int(duration_sec))
+        elif duration_sec < 3600:
+            duration = _("info.dur_min", n=int(duration_sec / 60))
+        else:
+            hours = int(duration_sec / 3600)
+            mins = int((duration_sec % 3600) / 60)
+            duration = _("info.dur_hours", h=hours, m=mins)
+
+    ti = info["tokens_input"]
+    to = info["tokens_output"]
+    tr = info["tokens_reasoning"]
+    tokens_str = f"{format_tokens(ti)} in · {format_tokens(to)} out"
+    if tr:
+        tokens_str += f" · {format_tokens(tr)} reason"
+
+    cost = format_cost(info["cost"])
+
+    project_name = None
+    if info["project_id"]:
+        project_name = get_project_name(db, info["project_id"])
+
+    sep = f"{sty.get('M', '')}{'─' * 60}{sty.get('R', '')}"
+    lr = sty.get("R", "")
+
+    lines = []
+    lines.append("")
+    lines.append(f"{sty.get('B', '')}{sty.get('C', '')}🔍 {_('view.header')}{lr}")
+    lines.append(sep)
+    lines.append(f"  {_('info.id')}:       {info['id']}")
+    lines.append(f"  {_('list.header.title')}: {title}")
+    lines.append(f"  {_('info.model')}:   {model}")
+    lines.append(f"  {_('info.agent')}:    {info['agent'] or '—'}")
+    lines.append(f"  {_('info.created')}:  {created}")
+    lines.append(f"  {_('info.duration')}: {duration}")
+    lines.append(f"  {_('info.tokens_total')}: {tokens_str}")
+    lines.append(f"  {_('info.cost')}:       {cost}")
+    if project_name:
+        lines.append(f"  {_('info.project')}:   {project_name}")
+    lines.append(f"  {_('info.messages')}: {msg_count}")
+    lines.append(sep)
+    lines.append("")
+
+    if not messages:
+        lines.append(f"  {sty.get('M', '')}{_('view.no_messages')}{lr}")
+        lines.append("")
+        lines.append(sep)
+        lines.append("")
+    else:
+        for msg in messages:
+            role = msg.get("role", "unknown")
+            ts = format_ts(msg.get("time"), "%Y-%m-%d %H:%M:%S") if msg.get("time") else ""
+            agent = msg.get("agent", "")
+
+            if role == "user":
+                role_str = f"{sty.get('G', '')}👤 {_('view.role_user')} [{ts}]{lr}"
+            elif role == "assistant":
+                agent_tag = f" ({agent})" if agent else ""
+                role_str = f"{sty.get('C', '')}🤖 {_('view.role_assistant')}{agent_tag} [{ts}]{lr}"
+            else:
+                role_str = f"{sty.get('Y', '')}⚙️ {role} [{ts}]{lr}"
+
+            lines.append(sep)
+            lines.append(role_str)
+            lines.append(sep)
+
+            for i, part in enumerate(msg.get("parts", [])):
+                formatted = _format_part_ansi(part, sty)
+                if formatted:
+                    if i > 0:
+                        lines.append("")
+                    lines.append(formatted)
+
+    lines.append(f"{sty.get('M', '')}─── {_('view.footer')} ───{lr}")
+    lines.append("")
+
+    return "\n".join(lines)
+
+
+# ======================================================================
+# Part formatting (ANSI version of format_part_to_md)
+# ======================================================================
+
+
+def _format_part_ansi(part, sty) -> str:
+    """Форматирует часть сообщения с ANSI-цветами."""
+    t = part.get("type", "")
+
+    if t == "text":
+        text = part.get("text", "").strip()
+        if not text:
+            return ""
+        return md_render(text, sty, plain=not sty)
+
+    if t == "reasoning":
+        text = part.get("text", "").strip()
+        if not text:
+            return ""
+        title = f"{sty.get('Y', '')}{sty.get('D', '')}💭 {_('md.reasoning')}:{sty.get('R', '')}"
+        body = f"{sty.get('D', '')}{text}{sty.get('R', '')}"
+        return f"{title}\n{body}"
+
+    if t == "sound":
+        return f"{sty.get('Y', '')}*🔊 {_('md.sound')}*{sty.get('R', '')}"
+
+    if t == "tool":
+        tool_name = part.get("tool", "?")
+        t_input = part.get("input", {})
+        t_output = part.get("output", "")
+        t_status = part.get("status", "")
+
+        icon = {"completed": "✅", "error": "❌", "running": "⏳"}.get(t_status, "🔧")
+        y = sty.get("Y", "")
+        r = sty.get("R", "")
+
+        if tool_name == "read":
+            fp = t_input.get("filePath", "")
+            return f"{y}{icon} read:{r} `{fp}`"
+        if tool_name == "write":
+            fp = t_input.get("filePath", "")
+            return f"{y}{icon} write:{r} `{fp}`"
+        if tool_name == "edit":
+            fp = t_input.get("filePath", "")
+            return f"{y}{icon} edit:{r} `{fp}`"
+        if tool_name == "glob":
+            pat = t_input.get("pattern", "")
+            pth = t_input.get("path", "")
+            if pth:
+                return f"{y}{icon} glob:{r} `{pat}` in `{pth}`"
+            return f"{y}{icon} glob:{r} `{pat}`"
+        if tool_name == "grep":
+            pat = t_input.get("pattern", "")
+            return f"{y}{icon} grep:{r} `{pat}`"
+
+        lines = [f"{y}{icon} {tool_name}{r}"]
+        if t_input:
+            for k, v in t_input.items():
+                s = str(v)
+                if len(s) > 200:
+                    s = s[:200] + "..."
+                lines.append(f"  {k}: {s}")
+        if t_output:
+            out = str(t_output).strip()
+            if out:
+                if len(out) > 300:
+                    out = out[:300] + "..."
+                lines.append(f"  → {out}")
+        return "\n".join(lines)
+
+    return ""
+
+
+# ======================================================================
+# Pager
+# ======================================================================
+
+
+def _page_text(text: str) -> None:
+    """Pipe text through $PAGER or less -R."""
+    pager_cmd = os.environ.get("PAGER", "")
+    try:
+        if pager_cmd:
+            subprocess.run(pager_cmd, input=text, text=True, shell=True)
+        elif shutil.which("less"):
+            subprocess.run(["less", "-R"], input=text, text=True)
+        else:
+            sys.stdout.write(text)
+            if not text.endswith("\n"):
+                sys.stdout.write("\n")
+            sys.stdout.flush()
+    except OSError:
+        sys.stdout.write(text)
+        if not text.endswith("\n"):
+            sys.stdout.write("\n")
+        sys.stdout.flush()