PyPI - log4lab - Versions diffs - 0.0.2__py3-none-any.whl - Mend

log4lab 0.0.2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

log4lab/__init__.py +1 -0
log4lab/cli.py +123 -0
log4lab/export.py +744 -0
log4lab/server.py +155 -0
log4lab/tail.py +283 -0
log4lab/templates/index.html +717 -0
log4lab/templates/runs.html +182 -0
log4lab-0.0.2.dist-info/METADATA +222 -0
log4lab-0.0.2.dist-info/RECORD +15 -0
log4lab-0.0.2.dist-info/WHEEL +5 -0
log4lab-0.0.2.dist-info/entry_points.txt +2 -0
log4lab-0.0.2.dist-info/licenses/LICENSE +21 -0
log4lab-0.0.2.dist-info/top_level.txt +2 -0
tests/__init__.py +1 -0
tests/test_server.py +214 -0

log4lab/templates/runs.html ADDED Viewed

@@ -0,0 +1,182 @@
+<!DOCTYPE html>
+<html lang="en" class="dark:bg-gray-900 dark:text-gray-100">
+<head>
+  <meta charset="UTF-8">
+  <title>Log4Lab — Run IDs</title>
+  <script src="https://cdn.tailwindcss.com"></script>
+  <script>
+    if (localStorage.theme === 'dark' ||
+        (!('theme' in localStorage) && window.matchMedia('(prefers-color-scheme: dark)').matches)) {
+      document.documentElement.classList.add('dark');
+    } else {
+      document.documentElement.classList.remove('dark');
+    }
+  </script>
+</head>
+<body class="bg-gray-50 dark:bg-gray-900 text-gray-900 dark:text-gray-100 transition-colors">
+  <div class="max-w-6xl mx-auto p-6">
+    <div class="flex justify-between items-center mb-6">
+      <h1 class="text-3xl font-bold">Log4Lab <span class="text-sm font-light">(Runs Index)</span></h1>
+      <div class="flex space-x-2">
+        <a href="/" class="px-3 py-1 rounded border text-sm bg-white dark:bg-gray-800 hover:bg-gray-100 dark:hover:bg-gray-700">
+          📊 View Logs
+        </a>
+        <button id="themeToggle"
+          class="px-3 py-1 rounded border text-sm bg-gray-200 dark:bg-gray-800 hover:bg-gray-300 dark:hover:bg-gray-700">
+          Toggle Theme
+        </button>
+      </div>
+    </div>
+    <div class="mb-4 p-4 bg-blue-50 dark:bg-blue-900/20 rounded border border-blue-200 dark:border-blue-800">
+      <p class="text-sm text-blue-800 dark:text-blue-200">
+        Click on a run name to view all runs, or click on a specific run ID to view that run's logs.
+      </p>
+    </div>
+    <div id="loading" class="text-center py-8">
+      <div class="inline-block animate-spin rounded-full h-8 w-8 border-b-2 border-gray-900 dark:border-gray-100"></div>
+      <p class="mt-2 text-gray-600 dark:text-gray-400">Loading runs...</p>
+    </div>
+    <div id="run-container" class="hidden">
+      <div class="mb-4 text-sm text-gray-600 dark:text-gray-400">
+        Found <span id="run-count" class="font-semibold">0</span> unique run names
+      </div>
+      <div id="run-list" class="space-y-4"></div>
+    </div>
+    <div id="no-runs" class="hidden text-center py-8 text-gray-600 dark:text-gray-400">
+      <p>No runs found in the log file.</p>
+      <p class="text-sm mt-2">Runs are identified by the "run_name" and "run_id" fields in log entries.</p>
+    </div>
+  </div>
+  <script>
+  const themeToggle = document.getElementById("themeToggle");
+  const loading = document.getElementById("loading");
+  const runContainer = document.getElementById("run-container");
+  const noRuns = document.getElementById("no-runs");
+  const runList = document.getElementById("run-list");
+  const runCount = document.getElementById("run-count");
+  themeToggle.onclick = () => {
+    const html = document.documentElement;
+    if (html.classList.contains('dark')) {
+      html.classList.remove('dark');
+      localStorage.theme = 'light';
+    } else {
+      html.classList.add('dark');
+      localStorage.theme = 'dark';
+    }
+  };
+  // Helper function to format date and calculate duration
+  function formatRunInfo(earliest, latest) {
+    if (!earliest) {
+      return { date: 'N/A', duration: 'N/A' };
+    }
+    // Handle timestamp with or without 'Z'
+    let ts = earliest;
+    if (!ts.endsWith('Z') && !ts.includes('+') && !ts.includes('-', 10)) {
+      ts = ts + 'Z';
+    }
+    const startDate = new Date(ts);
+    const dateStr = startDate.toLocaleDateString('en-US', {
+      month: 'short',
+      day: 'numeric',
+      year: 'numeric',
+      hour: '2-digit',
+      minute: '2-digit'
+    });
+    if (!latest || earliest === latest) {
+      return { date: dateStr, duration: '0h' };
+    }
+    // Calculate duration in hours
+    let tsLatest = latest;
+    if (!tsLatest.endsWith('Z') && !tsLatest.includes('+') && !tsLatest.includes('-', 10)) {
+      tsLatest = tsLatest + 'Z';
+    }
+    const endDate = new Date(tsLatest);
+    const durationMs = endDate - startDate;
+    const durationHours = Math.round(durationMs / (1000 * 60 * 60) * 10) / 10; // Round to 1 decimal
+    return {
+      date: dateStr,
+      duration: durationHours >= 1 ? `${durationHours}h` : `${Math.round(durationMs / (1000 * 60))}m`
+    };
+  }
+  // Fetch runs from server
+  fetch('/api/runs')
+    .then(response => response.json())
+    .then(data => {
+      loading.classList.add('hidden');
+      if (data.runs && Object.keys(data.runs).length > 0) {
+        runContainer.classList.remove('hidden');
+        runCount.textContent = Object.keys(data.runs).length;
+        Object.keys(data.runs).sort().forEach(runName => {
+          const runData = data.runs[runName];
+          const totalLogs = runData.total;
+          const runIds = runData.run_ids;
+          const div = document.createElement('div');
+          div.className = 'p-4 bg-white dark:bg-gray-800 border-2 border-gray-300 dark:border-gray-700 rounded';
+          div.innerHTML = `
+            <div class="flex justify-between items-center mb-3">
+              <div class="flex-1">
+                <a href="/?run_name=${encodeURIComponent(runName)}"
+                   class="text-xl font-semibold text-blue-600 dark:text-blue-400 hover:underline">
+                  ${runName}
+                </a>
+                <p class="text-sm text-gray-600 dark:text-gray-400 mt-1">
+                  ${totalLogs} log ${totalLogs === 1 ? 'entry' : 'entries'} across ${runIds.length} run${runIds.length === 1 ? '' : 's'}
+                </p>
+              </div>
+              <div>
+                <a href="/?run_name=${encodeURIComponent(runName)}"
+                   class="px-4 py-2 bg-blue-500 hover:bg-blue-600 text-white rounded text-sm">
+                  View All →
+                </a>
+              </div>
+            </div>
+            <div class="border-t border-gray-200 dark:border-gray-700 pt-3 mt-3">
+              <p class="text-xs font-semibold text-gray-500 dark:text-gray-400 mb-2">INDIVIDUAL RUNS:</p>
+              <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-2">
+                ${runIds.map(runIdInfo => {
+                  const info = formatRunInfo(runIdInfo.earliest, runIdInfo.latest);
+                  return `
+                  <a href="/?run_id=${encodeURIComponent(runIdInfo.run_id)}"
+                     class="px-3 py-2 bg-gray-100 dark:bg-gray-700 hover:bg-gray-200 dark:hover:bg-gray-600 rounded text-sm border border-gray-300 dark:border-gray-600 transition">
+                    <div class="text-xs font-semibold text-gray-600 dark:text-gray-300">${info.date}</div>
+                    <div class="text-xs text-gray-600 dark:text-gray-400 mt-1">
+                      Duration: ${info.duration} • ${runIdInfo.count} ${runIdInfo.count === 1 ? 'entry' : 'entries'}
+                    </div>
+                  </a>
+                `}).join('')}
+              </div>
+            </div>
+          `;
+          runList.appendChild(div);
+        });
+      } else {
+        noRuns.classList.remove('hidden');
+      }
+    })
+    .catch(error => {
+      loading.classList.add('hidden');
+      noRuns.classList.remove('hidden');
+      console.error('Error fetching runs:', error);
+    });
+  </script>
+</body>
+</html>

log4lab-0.0.2.dist-info/METADATA ADDED Viewed

@@ -0,0 +1,222 @@
+Metadata-Version: 2.4
+Name: log4lab
+Version: 0.0.2
+Summary: A lightweight structured log viewer with live streaming and filters.
+Author: Thibaut Lamadon
+License: MIT License
+        Copyright (c) 2025 Thibaut Lamadon
+        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.
+Project-URL: Homepage, https://github.com/tlamadon/log4lab
+Project-URL: Repository, https://github.com/tlamadon/log4lab
+Project-URL: Issues, https://github.com/tlamadon/log4lab/issues
+Keywords: logging,log-viewer,structured-logs,jsonl,monitoring,dashboard,live-streaming
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Logging
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi
+Requires-Dist: uvicorn
+Requires-Dist: jinja2
+Requires-Dist: typer
+Requires-Dist: rich>=13.0.0
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21; extra == "test"
+Requires-Dist: pytest-cov>=4.0; extra == "test"
+Requires-Dist: httpx>=0.24; extra == "test"
+Provides-Extra: images
+Requires-Dist: term-image>=0.7.0; extra == "images"
+Dynamic: license-file
+# Log4Lab
+A lightweight structured log viewer with live streaming, filtering, and rich content rendering.
+Log4Lab is a web-based dashboard for viewing and analyzing structured JSON logs in real-time. It provides a clean interface for monitoring application logs with live updates, making it easy to track experiments and debug issues.
+## Installation
+### Using pipx (Recommended)
+Install log4lab as an isolated application:
+```bash
+pipx install log4lab
+```
+### Using pip
+```bash
+pip install log4lab
+```
+### From source
+```bash
+git clone https://github.com/tlamadon/log4lab.git
+cd log4lab
+pip install -e .
+```
+## Quick Start
+1. **Start the web interface:**
+   ```bash
+   log4lab serve logs/app.log
+   ```
+   Then open http://localhost:8000
+2. **View logs in terminal:**
+   ```bash
+   log4lab tail logs/app.log
+   ```
+3. **Export to HTML:**
+   ```bash
+   log4lab export logs/app.log -o report.html
+   ```
+## Log Format
+Log4Lab expects JSONL format (one JSON object per line):
+```json
+{"time": "2025-02-03T10:30:00Z", "level": "INFO", "section": "train", "message": "Training started"}
+{"time": "2025-02-03T10:30:05Z", "level": "WARN", "section": "data", "message": "Missing data point"}
+{"time": "2025-02-03T10:30:10Z", "level": "ERROR", "section": "model", "message": "Model failed to converge"}
+```
+### With Rich Content
+Log4Lab can display various file types when you include a `cache_path` field:
+```json
+{
+  "time": "2025-02-03T10:30:00Z",
+  "level": "INFO",
+  "section": "train",
+  "message": "Training complete",
+  "cache_path": "artifacts/results.png",
+  "run_name": "experiment_1",
+  "accuracy": 0.95
+}
+```
+**Supported content types:**
+- **Images**: PNG, JPG, SVG, etc. (displayed inline)
+- **Code files**: Python, JavaScript, JSON, YAML, etc. (syntax highlighted, collapsible)
+- **Markdown**: .md files (rendered as HTML, collapsible)
+- **PDFs**: Embedded viewer
+- **Other files**: Download links
+### Core Fields
+- `time`: Timestamp in ISO 8601 format
+- `level`: Log level (INFO, WARN, ERROR, DEBUG)
+- `section`: Component or module name
+- `message` or `msg`: Main log message
+- `cache_path`: Path to artifact file
+- `run_name`: Name of the run collection
+- `run_id`: Unique run identifier
+Any additional fields are shown in the expandable JSON view.
+## Commands
+### Serve (Web Interface)
+```bash
+log4lab serve [LOGFILE]
+# Options:
+--host 0.0.0.0        # Bind to all interfaces (default: 127.0.0.1)
+--port 3000           # Custom port (default: 8000)
+--reload              # Auto-reload for development
+```
+### Tail (Terminal)
+```bash
+log4lab tail [LOGFILE]
+# Options:
+--level ERROR         # Filter by log level
+--open-images         # Open images automatically
+```
+### Export
+```bash
+log4lab export [LOGFILE] -o output.html
+# Options:
+-o, --output FILE     # Output file path
+-t, --title TEXT      # Custom page title
+--no-embed-images     # Don't embed images (smaller file)
+```
+## Filtering
+The web interface supports:
+- **Level filtering**: Dropdown with all levels found in logs
+- **Text filters**: Section, run name, run ID (partial matching)
+- **Time range**: Last 1m, 5m, 30m, 1h, 6h, 24h
+- **URL filters**: Bookmark and share filtered views
+```
+# Filter by error logs from last hour
+http://localhost:8000/?level=error&time=3600
+# View specific run
+http://localhost:8000/?run_name=experiment_1
+```
+## Use Cases
+**Machine Learning**: Track training runs with metrics and plots
+```json
+{"run_name": "resnet_training", "epoch": 10, "loss": 0.23, "cache_path": "plots/loss.png"}
+```
+**Debugging**: Monitor distributed systems across components
+```json
+{"section": "api", "level": "ERROR", "message": "Connection timeout", "duration_ms": 5000}
+```
+**Research**: Document experiments with artifacts
+```json
+{"run_name": "param_sweep", "message": "Testing lr=0.001", "cache_path": "results.pdf"}
+```
+## License
+MIT

log4lab-0.0.2.dist-info/RECORD ADDED Viewed

@@ -0,0 +1,15 @@
+log4lab/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+log4lab/cli.py,sha256=GodvLIcU1SQnqvwzJzQhiqzPLyQWV62DjBhc9hzgavk,4105
+log4lab/export.py,sha256=VbThX0xFmJuqM3NXpTPJSTOiEiA_HwLT5XHorw1bRsk,27118
+log4lab/server.py,sha256=a_YBuVGMT7kRpqreIYci92Uc_gsNGBf4vctUJ2kFcLk,5728
+log4lab/tail.py,sha256=GjGFt0Tv-q8IXzn-fx6FidyNVqp5SjJljLFGD-X8BIo,10633
+log4lab/templates/index.html,sha256=Dx_FvPUHpZwjefevq9-vG9o6_D70j-uK4FUO3OYjgc4,28644
+log4lab/templates/runs.html,sha256=G2RJDJ8AmnDKFjw-6psvXk0vpLOberuRfcmAZBv6Kx0,7117
+log4lab-0.0.2.dist-info/licenses/LICENSE,sha256=_85wPgyXGMMXDX1ms9iKkJZWt4_vB4HS9t7GHiIfZ1Q,1072
+tests/__init__.py,sha256=yW0onu9xodryo1GfHYJjOSfuLXy6K_v9pLxSJchJdJw,21
+tests/test_server.py,sha256=FUIEc-lpi8P9sSA8TNAHQ6WWnLBtrqLGpg58R6uQSfA,6736
+log4lab-0.0.2.dist-info/METADATA,sha256=ea5N1Fef4j2mACaOwQd99Ls3QfTTZ4mQIYqvhW5sAXg,6596
+log4lab-0.0.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+log4lab-0.0.2.dist-info/entry_points.txt,sha256=65wVwwTX1qbSz_45R5vCxwY5JgEZeQGJ5liy301mF6I,44
+log4lab-0.0.2.dist-info/top_level.txt,sha256=yKLnl06W1Q-LESO4FPA-9dzSceCDusANhZV3jmyRYTc,14
+log4lab-0.0.2.dist-info/RECORD,,

log4lab-0.0.2.dist-info/WHEEL ADDED Viewed

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

log4lab-0.0.2.dist-info/entry_points.txt ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ [console_scripts]
2	+ log4lab = log4lab.cli:app

log4lab-0.0.2.dist-info/licenses/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2025 Thibaut Lamadon
+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.

log4lab-0.0.2.dist-info/top_level.txt ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ log4lab
2	+ tests

tests/__init__.py ADDED Viewed

	@@ -0,0 +1 @@
1	+ # Tests for LogBoard

tests/test_server.py ADDED Viewed

@@ -0,0 +1,214 @@
+"""Tests for Log4Lab server endpoints."""
+import json
+import tempfile
+from pathlib import Path
+import pytest
+from fastapi.testclient import TestClient
+from log4lab import server
+@pytest.fixture
+def temp_log_file():
+    """Create a temporary log file with test data."""
+    with tempfile.NamedTemporaryFile(mode='w', suffix='.jsonl', delete=False) as f:
+        # Write test log entries
+        logs = [
+            {
+                "time": "2025-10-24T10:00:00Z",
+                "level": "INFO",
+                "section": "test",
+                "message": "First log entry",
+                "run_name": "test_run",
+                "run_id": "run_001",
+                "group": "test_group"
+            },
+            {
+                "time": "2025-10-24T10:05:00Z",
+                "level": "ERROR",
+                "section": "test",
+                "message": "Error log entry",
+                "run_name": "test_run",
+                "run_id": "run_001"
+            },
+            {
+                "time": "2025-10-24T11:00:00Z",
+                "level": "INFO",
+                "section": "another",
+                "message": "Different run",
+                "run_name": "test_run",
+                "run_id": "run_002"
+            },
+            {
+                "time": "2025-10-24T12:00:00Z",
+                "level": "DEBUG",
+                "section": "debug",
+                "message": "Debug message",
+                "run_name": "another_run",
+                "run_id": "run_003"
+            }
+        ]
+        for log in logs:
+            f.write(json.dumps(log) + '\n')
+        temp_path = Path(f.name)
+    yield temp_path
+    # Cleanup
+    temp_path.unlink()
+@pytest.fixture
+def client(temp_log_file):
+    """Create a test client with a temporary log file."""
+    server.set_log_path(temp_log_file)
+    return TestClient(server.app)
+def test_index_page(client):
+    """Test that the index page loads successfully."""
+    response = client.get("/")
+    assert response.status_code == 200
+    assert "Log4Lab" in response.text
+    assert "Live" in response.text
+def test_runs_page(client):
+    """Test that the runs index page loads successfully."""
+    response = client.get("/runs")
+    assert response.status_code == 200
+    assert "Log4Lab" in response.text
+    assert "Runs Index" in response.text
+def test_api_runs_endpoint(client, temp_log_file):
+    """Test the /api/runs endpoint returns correct data structure."""
+    response = client.get("/api/runs")
+    assert response.status_code == 200
+    data = response.json()
+    assert "runs" in data
+    # Check that we have the expected run names
+    assert "test_run" in data["runs"]
+    assert "another_run" in data["runs"]
+    # Check test_run structure
+    test_run = data["runs"]["test_run"]
+    assert "total" in test_run
+    assert "run_ids" in test_run
+    assert test_run["total"] == 3  # Three entries for test_run
+    # Check run_ids structure
+    assert len(test_run["run_ids"]) == 2  # run_001 and run_002
+    run_id_001 = next(r for r in test_run["run_ids"] if r["run_id"] == "run_001")
+    assert run_id_001["count"] == 2
+    assert run_id_001["earliest"] == "2025-10-24T10:00:00Z"
+    assert run_id_001["latest"] == "2025-10-24T10:05:00Z"
+    run_id_002 = next(r for r in test_run["run_ids"] if r["run_id"] == "run_002")
+    assert run_id_002["count"] == 1
+    assert run_id_002["earliest"] == "2025-10-24T11:00:00Z"
+def test_api_runs_empty_file():
+    """Test /api/runs with an empty log file."""
+    with tempfile.NamedTemporaryFile(mode='w', suffix='.jsonl', delete=False) as f:
+        temp_path = Path(f.name)
+    try:
+        server.set_log_path(temp_path)
+        client = TestClient(server.app)
+        response = client.get("/api/runs")
+        assert response.status_code == 200
+        data = response.json()
+        assert data["runs"] == {}
+    finally:
+        temp_path.unlink()
+def test_api_runs_no_run_fields():
+    """Test /api/runs with logs that don't have run_name/run_id fields."""
+    with tempfile.NamedTemporaryFile(mode='w', suffix='.jsonl', delete=False) as f:
+        logs = [
+            {"time": "2025-10-24T10:00:00Z", "level": "INFO", "message": "No run info"},
+            {"time": "2025-10-24T10:05:00Z", "level": "ERROR", "message": "Another entry"}
+        ]
+        for log in logs:
+            f.write(json.dumps(log) + '\n')
+        temp_path = Path(f.name)
+    try:
+        server.set_log_path(temp_path)
+        client = TestClient(server.app)
+        response = client.get("/api/runs")
+        assert response.status_code == 200
+        data = response.json()
+        assert data["runs"] == {}
+    finally:
+        temp_path.unlink()
+def test_cache_file_serving(client, temp_log_file):
+    """Test serving cache files from the log directory."""
+    # Create a test file in the same directory as the log file
+    log_dir = temp_log_file.parent
+    test_file = log_dir / "test_artifact.txt"
+    test_file.write_text("Test artifact content")
+    try:
+        response = client.get("/cache/test_artifact.txt")
+        assert response.status_code == 200
+        assert response.text == "Test artifact content"
+    finally:
+        test_file.unlink()
+def test_cache_file_not_found(client):
+    """Test that non-existent cache files return 404."""
+    response = client.get("/cache/nonexistent.txt")
+    assert response.status_code == 404
+def test_cache_file_path_traversal_protection(client):
+    """Test that path traversal attacks are blocked."""
+    response = client.get("/cache/../../../etc/passwd")
+    # Should return an error code (403, 400, or 404 if path doesn't resolve)
+    assert response.status_code in [403, 400, 404]
+    # Most importantly, should NOT return 200
+    assert response.status_code != 200
+def test_get_set_log_path(temp_log_file):
+    """Test the get_log_path and set_log_path functions."""
+    server.set_log_path(temp_log_file)
+    assert server.get_log_path() == temp_log_file
+def test_invalid_json_lines(client):
+    """Test that invalid JSON lines are skipped gracefully."""
+    with tempfile.NamedTemporaryFile(mode='w', suffix='.jsonl', delete=False) as f:
+        f.write('{"valid": "json"}\n')
+        f.write('invalid json line\n')
+        f.write('{"another": "valid", "run_name": "test", "run_id": "1"}\n')
+        temp_path = Path(f.name)
+    try:
+        server.set_log_path(temp_path)
+        client = TestClient(server.app)
+        response = client.get("/api/runs")
+        assert response.status_code == 200
+        data = response.json()
+        # Should only count the valid entries with run info
+        assert len(data["runs"]) == 1
+        assert "test" in data["runs"]
+    finally:
+        temp_path.unlink()