tracetui 2.0.0__tar.gz

tracetui-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TraceTUI Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tracetui-2.0.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: tracetui
+Version: 2.0.0
+Summary: Interactive TUI debugger for logs with real-time parsing and filtering
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: textual>=1.0.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# TraceTUI
+
+<p align="left">
+  <a href="./README.md">🇺🇸 English</a> • 
+  <a href="./README.ru.md">🇷🇺 Русский</a>
+</p>
+
+**Interactive TUI debugger for logs** — a beautiful console interface built on [Textual](https://textual.io/) that parses logs (`loguru`, `logging`) in real-time, highlights errors, and lets you filter them with arrow keys.
+
+![Tests](https://github.com/slimeopus/TraceTUI/actions/workflows/tests.yml/badge.svg)
+![Python Version](https://img.shields.io/badge/python-3.10+-blue.svg)
+![License](https://img.shields.io/github/license/slimeopus/TraceTUI)
+![Version](https://img.shields.io/badge/version-2.0.0-34C4C4.svg?style=flat)
+
+![Preview](.github/assets/preview.png)
+
+## ✨ Features
+
+### Three-panel interface
+- **Left panel** — list of log sources/files with activity indicators
+- **Center panel** — log stream with color-coded severity levels
+- **Right panel** — selected entry details (traceback, metadata, tags)
+
+### Log formats
+- **loguru** — `2024-01-15 10:30:45 | ERROR | module.py:42 - message`
+- **logging** — `2024-01-15 10:30:45,123 - module.name - ERROR - message`
+- **Simple** — `ERROR - message`
+- **Auto-detect** — automatic format detection
+
+### Navigation & Control
+
+#### Log navigation
+- `↑` / `↓` — navigate through logs (by line)
+- Error blocks are highlighted on hover
+
+#### Source switching
+- `←` / `→` — switch between sources/log files
+- Active source is marked with `▸` in the left panel
+
+#### Keyboard shortcuts
+| Key | Action | Description |
+|-----|--------|-------------|
+| `F` | Filter | Filter mode — type text to search |
+| `E` | Next Error | Jump to next error (skip INFO/DEBUG) |
+| `T` | Theme | Switch theme (light/dark) |
+| `Q` | Quit | Exit the application |
+
+#### Additional capabilities
+- Copy traceback to clipboard
+- Add custom tags (labels)
+- Filter by level and text
+- Multiple log file support
+- **Timeline Merge Mode** (`m`) — cross-file event timeline with color-coded source tags
+
+## 📦 Installation
+
+### Via pip
+```bash
+pip install tracetui
+```
+
+### From source
+```bash
+git clone <repository-url>
+cd TraceTUI
+pip install -e .
+```
+
+### Dependencies
+- Python >= 3.10
+- textual >= 1.0.0
+- rich >= 13.0.0
+
+## 🚀 Usage
+
+### Quick start
+```bash
+# Run with sample logs
+tracetui sample_logs/app_standard.log
+tracetui sample_logs/app_loguru.log
+
+# Multiple files
+tracetui log1.log log2.log log3.log
+
+# With format specification
+tracetui -f loguru my_app.log
+tracetui -f logging server.log
+
+# Multiple files (timeline mode — press m in UI)
+tracetui app.log worker.log scheduler.log
+
+# Filter by level
+tracetui -l ERROR app.log
+```
+
+### Programmatic usage
+```python
+from tracetui.app import TraceTUIApp
+from tracetui.parsers.log_parser import load_log_source
+from pathlib import Path
+
+app = TraceTUIApp()
+
+# Load a file
+source = load_log_source(Path("app.log"))
+app.add_log_source(source)
+
+# Run
+app.run()
+```
+
+## 🧪 Testing
+
+```bash
+# Run all tests
+pytest
+
+# With verbose output
+pytest -v
+
+# With coverage
+pytest --cov=tracetui --cov-report=html
+```
+
+## 📝 Usage examples
+
+### Debugging an app with many errors
+```bash
+# Open a log with auto-detect format
+tracetui /var/log/myapp.log
+
+# Navigate with arrows to ERROR
+# Press Enter to view details
+# Check the traceback in the right panel
+# Press 'd' to mark as "investigate"
+```
+
+### Monitoring multiple files
+```bash
+# Open several logs simultaneously
+tracetui app.log worker.log scheduler.log
+```
+
+## 📄 License
+
+MIT
+
+---

tracetui-2.0.0/README.md

@@ -0,0 +1,148 @@
+# TraceTUI
+
+<p align="left">
+  <a href="./README.md">🇺🇸 English</a> • 
+  <a href="./README.ru.md">🇷🇺 Русский</a>
+</p>
+
+**Interactive TUI debugger for logs** — a beautiful console interface built on [Textual](https://textual.io/) that parses logs (`loguru`, `logging`) in real-time, highlights errors, and lets you filter them with arrow keys.
+
+![Tests](https://github.com/slimeopus/TraceTUI/actions/workflows/tests.yml/badge.svg)
+![Python Version](https://img.shields.io/badge/python-3.10+-blue.svg)
+![License](https://img.shields.io/github/license/slimeopus/TraceTUI)
+![Version](https://img.shields.io/badge/version-2.0.0-34C4C4.svg?style=flat)
+
+![Preview](.github/assets/preview.png)
+
+## ✨ Features
+
+### Three-panel interface
+- **Left panel** — list of log sources/files with activity indicators
+- **Center panel** — log stream with color-coded severity levels
+- **Right panel** — selected entry details (traceback, metadata, tags)
+
+### Log formats
+- **loguru** — `2024-01-15 10:30:45 | ERROR | module.py:42 - message`
+- **logging** — `2024-01-15 10:30:45,123 - module.name - ERROR - message`
+- **Simple** — `ERROR - message`
+- **Auto-detect** — automatic format detection
+
+### Navigation & Control
+
+#### Log navigation
+- `↑` / `↓` — navigate through logs (by line)
+- Error blocks are highlighted on hover
+
+#### Source switching
+- `←` / `→` — switch between sources/log files
+- Active source is marked with `▸` in the left panel
+
+#### Keyboard shortcuts
+| Key | Action | Description |
+|-----|--------|-------------|
+| `F` | Filter | Filter mode — type text to search |
+| `E` | Next Error | Jump to next error (skip INFO/DEBUG) |
+| `T` | Theme | Switch theme (light/dark) |
+| `Q` | Quit | Exit the application |
+
+#### Additional capabilities
+- Copy traceback to clipboard
+- Add custom tags (labels)
+- Filter by level and text
+- Multiple log file support
+- **Timeline Merge Mode** (`m`) — cross-file event timeline with color-coded source tags
+
+## 📦 Installation
+
+### Via pip
+```bash
+pip install tracetui
+```
+
+### From source
+```bash
+git clone <repository-url>
+cd TraceTUI
+pip install -e .
+```
+
+### Dependencies
+- Python >= 3.10
+- textual >= 1.0.0
+- rich >= 13.0.0
+
+## 🚀 Usage
+
+### Quick start
+```bash
+# Run with sample logs
+tracetui sample_logs/app_standard.log
+tracetui sample_logs/app_loguru.log
+
+# Multiple files
+tracetui log1.log log2.log log3.log
+
+# With format specification
+tracetui -f loguru my_app.log
+tracetui -f logging server.log
+
+# Multiple files (timeline mode — press m in UI)
+tracetui app.log worker.log scheduler.log
+
+# Filter by level
+tracetui -l ERROR app.log
+```
+
+### Programmatic usage
+```python
+from tracetui.app import TraceTUIApp
+from tracetui.parsers.log_parser import load_log_source
+from pathlib import Path
+
+app = TraceTUIApp()
+
+# Load a file
+source = load_log_source(Path("app.log"))
+app.add_log_source(source)
+
+# Run
+app.run()
+```
+
+## 🧪 Testing
+
+```bash
+# Run all tests
+pytest
+
+# With verbose output
+pytest -v
+
+# With coverage
+pytest --cov=tracetui --cov-report=html
+```
+
+## 📝 Usage examples
+
+### Debugging an app with many errors
+```bash
+# Open a log with auto-detect format
+tracetui /var/log/myapp.log
+
+# Navigate with arrows to ERROR
+# Press Enter to view details
+# Check the traceback in the right panel
+# Press 'd' to mark as "investigate"
+```
+
+### Monitoring multiple files
+```bash
+# Open several logs simultaneously
+tracetui app.log worker.log scheduler.log
+```
+
+## 📄 License
+
+MIT
+
+---

tracetui-2.0.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tracetui"
+version = "2.0.0"
+description = "Interactive TUI debugger for logs with real-time parsing and filtering"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+dependencies = [
+    "textual>=1.0.0",
+    "rich>=13.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+]
+
+[project.scripts]
+tracetui = "tracetui.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["tracetui*"]

tracetui-2.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tracetui-2.0.0/tests/test_anomaly_detection.py

@@ -0,0 +1,127 @@
+"""Тесты для автоматического обнаружения аномалий."""
+
+from tracetui.models import LogLevel, LogEntry
+from tracetui.widgets.log_list import LogList
+
+
+class TestAnomalyDetection:
+    """Тесты автоматического выделения аномалий."""
+
+    def test_error_level_is_anomaly(self):
+        """Уровень ERROR автоматически аномальный."""
+        log_list = LogList()
+        entry = LogEntry(level=LogLevel.ERROR, message="some info")
+        assert log_list._is_anomaly(entry) is True
+
+    def test_critical_level_is_anomaly(self):
+        """Уровень CRITICAL автоматически аномальный."""
+        log_list = LogList()
+        entry = LogEntry(level=LogLevel.CRITICAL, message="some info")
+        assert log_list._is_anomaly(entry) is True
+
+    def test_timeout_keyword_detected(self):
+        """Ключевое слово Timeout обнаруживается."""
+        log_list = LogList()
+        entry = LogEntry(level=LogLevel.WARNING, message="Request timeout after 30s")
+        assert log_list._is_anomaly(entry) is True
+
+    def test_connection_error_keyword_detected(self):
+        """Ключевое слово ConnectionError обнаруживается."""
+        log_list = LogList()
+        entry = LogEntry(level=LogLevel.ERROR, message="ConnectionError: host unreachable")
+        assert log_list._is_anomaly(entry) is True
+
+    def test_exception_keyword_detected(self):
+        """Ключевое слово Exception обнаруживается."""
+        log_list = LogList()
+        entry = LogEntry(level=LogLevel.ERROR, message="Unhandled exception in worker")
+        assert log_list._is_anomaly(entry) is True
+
+    def test_failure_keyword_detected(self):
+        """Ключевое слово Failure обнаруживается."""
+        log_list = LogList()
+        entry = LogEntry(level=LogLevel.WARNING, message="Task failure after 3 retries")
+        assert log_list._is_anomaly(entry) is True
+
+    def test_fatal_keyword_detected(self):
+        """Ключевое слово Fatal обнаруживается."""
+        log_list = LogList()
+        entry = LogEntry(level=LogLevel.ERROR, message="Fatal error in main loop")
+        assert log_list._is_anomaly(entry) is True
+
+    def test_status_code_500_detected(self):
+        """HTTP 500 обнаруживается."""
+        log_list = LogList()
+        entry = LogEntry(level=LogLevel.WARNING, message="Server responded with 500")
+        assert log_list._is_anomaly(entry) is True
+
+    def test_status_code_503_detected(self):
+        """HTTP 503 обнаруживается."""
+        log_list = LogList()
+        entry = LogEntry(level=LogLevel.WARNING, message="Service 503 unavailable")
+        assert log_list._is_anomaly(entry) is True
+
+    def test_timed_out_keyword_detected(self):
+        """Фраза timed out обнаруживается."""
+        log_list = LogList()
+        entry = LogEntry(level=LogLevel.WARNING, message="Database connection timed out")
+        assert log_list._is_anomaly(entry) is True
+
+    def test_broken_pipe_detected(self):
+        """Фраза broken pipe обнаруживается."""
+        log_list = LogList()
+        entry = LogEntry(level=LogLevel.ERROR, message="Write failed: broken pipe")
+        assert log_list._is_anomaly(entry) is True
+
+    def test_normal_info_is_not_anomaly(self):
+        """Обычный INFO не является аномалией."""
+        log_list = LogList()
+        entry = LogEntry(level=LogLevel.INFO, message="Application started successfully")
+        assert log_list._is_anomaly(entry) is False
+
+    def test_normal_debug_is_not_anomaly(self):
+        """Обычный DEBUG не является аномалией."""
+        log_list = LogList()
+        entry = LogEntry(level=LogLevel.DEBUG, message="Processing request payload")
+        assert log_list._is_anomaly(entry) is False
+
+    def test_normal_warning_is_not_anomaly(self):
+        """Обычный WARNING без ключевых слов не аномалия."""
+        log_list = LogList()
+        entry = LogEntry(level=LogLevel.WARNING, message="Configuration file is outdated")
+        assert log_list._is_anomaly(entry) is False
+
+    def test_case_insensitive_detection(self):
+        """Проверка без учёта регистра."""
+        log_list = LogList()
+        entry = LogEntry(level=LogLevel.WARNING, message="TIMEOUT detected in module")
+        assert log_list._is_anomaly(entry) is True
+
+        entry2 = LogEntry(level=LogLevel.WARNING, message="Timeout in module")
+        assert log_list._is_anomaly(entry2) is True
+
+        entry3 = LogEntry(level=LogLevel.WARNING, message="tImeOuT occurred")
+        assert log_list._is_anomaly(entry3) is True
+
+    def test_anomaly_count_in_header(self):
+        """Подсчёт аномалий в заголовке."""
+        log_list = LogList()
+        entries = [
+            LogEntry(level=LogLevel.INFO, message="normal"),
+            LogEntry(level=LogLevel.ERROR, message="error"),
+            LogEntry(level=LogLevel.WARNING, message="timeout occurred"),
+            LogEntry(level=LogLevel.DEBUG, message="debug info"),
+        ]
+        log_list._entries = entries
+        # DataTable использует _build_line() вместо _build_lines()
+        # Проверяем аномалии через get_filtered_entries
+        filtered = log_list._get_filtered_entries()
+        anomaly_count = sum(1 for e in filtered if log_list._is_anomaly(e))
+        assert anomaly_count == 2
+
+    def test_custom_anomaly_keywords(self):
+        """Проверка что список ключевых слов не пустой."""
+        log_list = LogList()
+        assert len(log_list._anomaly_keywords) > 0
+        assert "timeout" in log_list._anomaly_keywords
+        assert "connectionerror" in log_list._anomaly_keywords

tracetui-2.0.0/tests/test_detail_panel.py

@@ -0,0 +1,98 @@
+"""Тесты для DetailPanel виджета."""
+
+from tracetui.models import LogLevel, LogEntry
+from tracetui.widgets.detail_panel import DetailPanel
+
+
+class TestDetailPanel:
+    """Тесты панели деталей."""
+
+    def test_initial_display(self):
+        """Начальное состояние — подсказка."""
+        panel = DetailPanel()
+        panel.on_mount()
+        assert "Select a log entry" in panel.text
+
+    def test_update_with_entry(self):
+        """Обновление деталями записи."""
+        panel = DetailPanel()
+        entry = LogEntry(
+            level=LogLevel.ERROR,
+            message="Something broke",
+            timestamp="2024-01-01 12:00:00",
+            logger_name="app.main",
+        )
+        panel.update_detail(entry)
+        assert "ERROR" in panel.text
+        assert "Something broke" in panel.text
+        assert "2024-01-01 12:00:00" in panel.text
+
+    def test_update_with_traceback(self):
+        """Отображение traceback."""
+        panel = DetailPanel()
+        entry = LogEntry(
+            level=LogLevel.ERROR,
+            message="Crash",
+            traceback="Traceback (most recent call last):\n  File 'app.py', line 10",
+        )
+        panel.update_detail(entry)
+        assert "Traceback" in panel.text
+        assert "app.py" in panel.text
+
+    def test_toggle_traceback_visible(self):
+        """Traceback виден."""
+        panel = DetailPanel()
+        panel._show_traceback = True
+        assert panel._show_traceback is True
+
+    def test_toggle_traceback_hidden(self):
+        """Traceback скрыт."""
+        panel = DetailPanel()
+        panel._show_traceback = False
+        assert panel._show_traceback is False
+
+    def test_toggle_traceback_action(self):
+        """Переключение через action."""
+        panel = DetailPanel()
+        initial = panel._show_traceback
+        panel.action_toggle_traceback()
+        assert panel._show_traceback == (not initial)
+
+    def test_update_none_entry(self):
+        """Обновление None — возврат к подсказке."""
+        panel = DetailPanel()
+        panel.update_detail(None)
+        assert "Select a log entry" in panel.text
+
+        entry = LogEntry(level=LogLevel.ERROR, message="test")
+        panel.update_detail(entry)
+        assert "test" in panel.text
+
+    def test_current_entry_property(self):
+        """Свойство current_entry."""
+        panel = DetailPanel()
+        assert panel.current_entry is None
+
+        entry = LogEntry(level=LogLevel.INFO, message="test")
+        panel.update_detail(entry)
+        assert panel.current_entry is entry
+
+    def test_detail_with_tags(self):
+        """Отображение тегов."""
+        panel = DetailPanel()
+        entry = LogEntry(
+            level=LogLevel.ERROR,
+            message="error",
+            tags=["исследовать", "решено"],
+        )
+        panel.update_detail(entry)
+        assert "исследовать" in panel.text
+        assert "решено" in panel.text
+
+    def test_detail_without_optional_fields(self):
+        """Минимальная запись без timestamp/logger."""
+        panel = DetailPanel()
+        entry = LogEntry(level=LogLevel.INFO, message="simple")
+        panel.update_detail(entry)
+        assert "INFO" in panel.text
+        assert "simple" in panel.text