seejx 0.3.0__tar.gz

seejx-0.3.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Lei Zhang (original "seej" project)
+Copyright (c) 2025 seejx 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.

seejx-0.3.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE
+include NOTICE
+include README.md

seejx-0.3.0/NOTICE

@@ -0,0 +1,28 @@
+seejx
+=====
+
+This project is a fork of the "seej" package:
+
+    seej — Interactive JSONL browser with rich rendering
+    Copyright (c) 2025 Lei Zhang
+    Author-email: Jiaxi Yang <jason.yang98@foxmail.com>
+    License: MIT
+    https://pypi.org/project/seej/
+
+seejx redistributes and modifies that MIT-licensed code. The original MIT
+license and copyright notice are retained in the LICENSE file.
+
+Modifications in seejx
+----------------------
+- Replaced the per-record "clear screen + reprint" navigation with a built-in
+  full-screen scroll viewer (alternate screen buffer):
+    * trackpad / mouse-wheel (SGR mouse reporting), arrow keys, j/k line scroll
+    * PageUp/PageDown / Space / b page scroll; g / G jump to top / bottom
+    * left / right (or n / p / Enter) to move between records
+    * the whole record is held in memory, so the top/bottom is always reachable
+      regardless of terminal scrollback size
+- wcwidth-aware line wrapping so CJK (double-width) text wraps correctly.
+- A soft, colored status bar (replacing the reverse-video footer).
+- Added `wcwidth` as a dependency.
+- Console entry point renamed to `seejx`; plugin entry-point group is
+  `seejx.plugins`.

seejx-0.3.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: seejx
+Version: 0.3.0
+Summary: Interactive JSONL browser with rich rendering and full-screen scrolling (fork of seej)
+Author-email: "busi.wp" <busi.wp@alibaba-inc.com>
+License: MIT License
+        
+        Copyright (c) 2025 Lei Zhang (original "seej" project)
+        Copyright (c) 2025 seejx 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.
+        
+Project-URL: Homepage, https://pypi.org/project/seejx/
+Keywords: jsonl,browser,cli,rich,viewer,tui,pager
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: rich>=10.0.0
+Requires-Dist: readchar>=3.0.0
+Requires-Dist: tqdm>=4.0.0
+Requires-Dist: wcwidth>=0.2.5
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=21.0; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Dynamic: license-file
+
+# seejx
+
+**seejx** is an interactive terminal JSONL (JSON Lines) browser with rich
+rendering and a built-in **full-screen scroll viewer**. It steps through
+`.jsonl` files record by record, with pluggable per-field renderers for complex
+data (chat messages, tables, nested structures).
+
+It is a fork of [`seej`](https://pypi.org/project/seej/) (MIT, © 2025 Lei Zhang)
+that replaces the old "clear-and-reprint" navigation with a proper scrollable
+pager — so long records scroll smoothly and you can always reach the top.
+
+## Features
+
+- **Full-screen scrolling** — trackpad / mouse wheel / arrow keys scroll within
+  a record; the whole record is kept in memory, so top and bottom are always
+  reachable (independent of terminal scrollback size).
+- **Rich output** — formatting via the [`rich`](https://github.com/Textualize/rich) library.
+- **CJK-aware wrapping** — double-width characters wrap correctly (via `wcwidth`).
+- **Per-field renderers** — map fields to renderers (messages, tables, nested structures).
+- **Filtering** — keep rows matching a safe Python expression.
+- **Plugins** — extend rendering via Python entry points (`seejx.plugins`).
+- **View modes** — toggle between rich and plain-text rendering.
+
+## Installation
+
+```bash
+pip install seejx
+```
+
+## Quick start
+
+```bash
+# Basic usage
+seejx path/to/file.jsonl
+
+# Start at a given record index
+seejx path/to/file.jsonl -I 10
+
+# Plain text instead of rich rendering
+seejx path/to/file.jsonl --raw
+```
+
+## Keys (in the viewer)
+
+| Key | Action |
+| --- | --- |
+| Two-finger swipe / mouse wheel / ↑ ↓ / `j` `k` | Scroll line by line |
+| PageUp / PageDown / Space / `b` | Scroll by page |
+| `g` / `G` | Jump to top / bottom |
+| → / ← (or `n` / `p` / Enter) | Next / previous record |
+| `t` | Toggle rich / raw rendering |
+| `q` (or Ctrl-C) | Quit |
+
+> Tip: while the viewer is open it captures the trackpad for scrolling. To
+> select text the normal way, hold **Option/Fn** while dragging.
+
+## License
+
+MIT. See [LICENSE](LICENSE) and [NOTICE](NOTICE) (fork attribution).

seejx-0.3.0/README.md

@@ -0,0 +1,59 @@
+# seejx
+
+**seejx** is an interactive terminal JSONL (JSON Lines) browser with rich
+rendering and a built-in **full-screen scroll viewer**. It steps through
+`.jsonl` files record by record, with pluggable per-field renderers for complex
+data (chat messages, tables, nested structures).
+
+It is a fork of [`seej`](https://pypi.org/project/seej/) (MIT, © 2025 Lei Zhang)
+that replaces the old "clear-and-reprint" navigation with a proper scrollable
+pager — so long records scroll smoothly and you can always reach the top.
+
+## Features
+
+- **Full-screen scrolling** — trackpad / mouse wheel / arrow keys scroll within
+  a record; the whole record is kept in memory, so top and bottom are always
+  reachable (independent of terminal scrollback size).
+- **Rich output** — formatting via the [`rich`](https://github.com/Textualize/rich) library.
+- **CJK-aware wrapping** — double-width characters wrap correctly (via `wcwidth`).
+- **Per-field renderers** — map fields to renderers (messages, tables, nested structures).
+- **Filtering** — keep rows matching a safe Python expression.
+- **Plugins** — extend rendering via Python entry points (`seejx.plugins`).
+- **View modes** — toggle between rich and plain-text rendering.
+
+## Installation
+
+```bash
+pip install seejx
+```
+
+## Quick start
+
+```bash
+# Basic usage
+seejx path/to/file.jsonl
+
+# Start at a given record index
+seejx path/to/file.jsonl -I 10
+
+# Plain text instead of rich rendering
+seejx path/to/file.jsonl --raw
+```
+
+## Keys (in the viewer)
+
+| Key | Action |
+| --- | --- |
+| Two-finger swipe / mouse wheel / ↑ ↓ / `j` `k` | Scroll line by line |
+| PageUp / PageDown / Space / `b` | Scroll by page |
+| `g` / `G` | Jump to top / bottom |
+| → / ← (or `n` / `p` / Enter) | Next / previous record |
+| `t` | Toggle rich / raw rendering |
+| `q` (or Ctrl-C) | Quit |
+
+> Tip: while the viewer is open it captures the trackpad for scrolling. To
+> select text the normal way, hold **Option/Fn** while dragging.
+
+## License
+
+MIT. See [LICENSE](LICENSE) and [NOTICE](NOTICE) (fork attribution).

seejx-0.3.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "seejx"
+version = "0.3.0"
+description = "Interactive JSONL browser with rich rendering and full-screen scrolling (fork of seej)"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { file = "LICENSE" }
+authors = [
+    { name = "busi.wp", email = "busi.wp@alibaba-inc.com" },
+]
+keywords = ["jsonl", "browser", "cli", "rich", "viewer", "tui", "pager"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX",
+    "Programming Language :: Python :: 3",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "rich>=10.0.0",
+    "readchar>=3.0.0",
+    "tqdm>=4.0.0",
+    "wcwidth>=0.2.5",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=6.0",
+    "pytest-cov>=4.0",
+    "black>=21.0",
+    "build>=1.0",
+    "twine>=4.0",
+]
+
+[project.scripts]
+seejx = "seejx.see_jsonl:main"
+
+[project.urls]
+Homepage = "https://pypi.org/project/seejx/"
+
+[tool.setuptools.packages.find]
+where = ["src"]

seejx-0.3.0/setup.cfg

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

seejx-0.3.0/src/seejx/__init__.py

@@ -0,0 +1,20 @@
+"""seejx - Interactive JSONL browser with rich rendering and full-screen scrolling.
+
+Fork of `seej` (MIT, © 2025 Lei Zhang) with an in-app full-screen scroll
+viewer: trackpad / mouse-wheel / arrow-key scrolling, wcwidth-aware wrapping,
+and a soft status bar. See NOTICE for details.
+"""
+
+__version__ = "0.3.0"
+
+from .see_jsonl import main
+from .renderers import register_renderer, get_renderer
+from .conditions import SafeExampleProxy, build_condition_function
+
+__all__ = [
+    "main",
+    "register_renderer",
+    "get_renderer",
+    "SafeExampleProxy",
+    "build_condition_function",
+]

seejx-0.3.0/src/seejx/conditions.py

@@ -0,0 +1,178 @@
+"""Condition parsing and evaluation for filtering examples."""
+
+import ast
+import operator
+from typing import Any, Callable, Optional
+from rich.console import Console
+
+console = Console()
+
+
+class SafeExampleProxy:
+    """安全的样本代理，支持 ex['key'] 和 ex.key 两种语法"""
+
+    def __init__(self, data: dict):
+        self._data = data
+
+    def __getitem__(self, key):
+        """支持 ex['key'] 语法"""
+        return self._data.get(key)
+
+    def __getattr__(self, key):
+        """支持 ex.key 语法"""
+        if key.startswith("_"):
+            raise AttributeError(f"Cannot access private attribute: {key}")
+        return self._data.get(key)
+
+    def __contains__(self, key):
+        """支持 'key' in ex"""
+        return key in self._data
+
+    def get(self, key, default=None):
+        """支持 ex.get('key', default)"""
+        return self._data.get(key, default)
+
+
+def create_safe_namespace():
+    """创建安全的执行命名空间"""
+    # 只允许安全的内置函数和操作符
+    safe_builtins = {
+        "len": len,
+        "str": str,
+        "int": int,
+        "float": float,
+        "bool": bool,
+        "list": list,
+        "dict": dict,
+        "tuple": tuple,
+        "set": set,
+        "abs": abs,
+        "min": min,
+        "max": max,
+        "sum": sum,
+        "any": any,
+        "all": all,
+        "isinstance": isinstance,
+        "True": True,
+        "False": False,
+        "None": None,
+    }
+    return safe_builtins
+
+
+def validate_condition_syntax(condition: str) -> tuple[bool, Optional[str]]:
+    """
+    验证条件表达式的语法安全性
+
+    Returns:
+        (is_valid, error_message)
+    """
+    # 检查是否包含 'ex'
+    if "ex" not in condition:
+        return False, "Condition must reference 'ex' (e.g., ex['field'] == 'value')"
+
+    # 尝试解析 AST
+    try:
+        tree = ast.parse(condition, mode="eval")
+    except SyntaxError as e:
+        return False, f"Syntax error: {e}"
+
+    # 检查危险操作
+    dangerous_nodes = (
+        ast.Import,
+        ast.ImportFrom,  # 禁止导入
+        ast.Call,  # 暂时禁止所有函数调用（可以放宽）
+    )
+
+    for node in ast.walk(tree):
+        # 允许安全的函数调用
+        if isinstance(node, ast.Call):
+            if isinstance(node.func, ast.Name):
+                func_name = node.func.id
+                if func_name not in create_safe_namespace():
+                    return False, f"Function '{func_name}' is not allowed"
+
+        # 禁止其他危险操作
+        if isinstance(node, (ast.Import, ast.ImportFrom)):
+            return False, "Import statements are not allowed"
+
+    return True, None
+
+
+def build_condition_function(conditions: list[str]) -> Optional[Callable]:
+    """
+    构建条件过滤函数
+
+    Args:
+        conditions: 条件表达式列表，例如 ["ex['type'] == 'chat'", "len(ex['messages']) > 5"]
+
+    Returns:
+        过滤函数或 None
+    """
+    if not conditions:
+        return None
+
+    console.print("[bold]Building filter conditions:[/bold]")
+
+    # 验证并处理每个条件
+    validated_conditions = []
+    for idx, cond in enumerate(conditions, 1):
+        cond = cond.strip()
+        if not cond:
+            continue
+
+        is_valid, error = validate_condition_syntax(cond)
+        if not is_valid:
+            console.print(f"[red]✗[/red] Condition {idx}: {cond}")
+            console.print(f"  [red]Error: {error}[/red]")
+            continue
+
+        validated_conditions.append(cond)
+        console.print(f"[green]✓[/green] Condition {idx}: [cyan]{cond}[/cyan]")
+
+    if not validated_conditions:
+        console.print("[yellow]Warning: No valid conditions, showing all examples[/yellow]")
+        return None
+
+    # 组合所有条件
+    combined_expr = " and ".join(f"({c})" for c in validated_conditions)
+    console.print(f"\n[bold]Combined:[/bold] [dim]{combined_expr}[/dim]\n")
+
+    # 编译表达式
+    try:
+        compiled_code = compile(combined_expr, "<condition>", "eval")
+    except Exception as e:
+        console.print(f"[red]Failed to compile conditions: {e}[/red]")
+        return None
+
+    # 创建安全的命名空间
+    safe_namespace = create_safe_namespace()
+
+    def condition_filter(example: dict) -> bool:
+        """实际的过滤函数"""
+        try:
+            # 创建代理对象
+            ex = SafeExampleProxy(example)
+            # 在安全命名空间中执行
+            namespace = {**safe_namespace, "ex": ex}
+            result = eval(compiled_code, {"__builtins__": {}}, namespace)
+            return bool(result)
+        except KeyError as e:
+            # 字段不存在时返回 False
+            return False
+        except Exception as e:
+            # 其他错误：打印警告但不中断
+            # console.print(f"[yellow]Warning: Condition evaluation error: {e}[/yellow]")
+            return False
+
+    try:
+        console.print(f"\n[red][bold]>>>Press any key to see jsonl!<<<\n[/bold][/red]")
+        input()
+    except KeyboardInterrupt:
+        console.print(f"\n[bold]Keyboard Interruptted[/bold]\n")
+        exit(0)
+
+    return condition_filter
+
+
+# ============ 向后兼容的旧版解析（可选保留） ============

seejx-0.3.0/src/seejx/config.py

@@ -0,0 +1,82 @@
+"""Configuration parsing for seejx."""
+
+from typing import Dict, Callable
+from rich.console import Console
+from rich.table import Table
+from .renderers.base import get_renderer, list_renderers, get_all_renderer_names
+
+console = Console()
+
+
+def parse_render_mappings(render_args) -> Dict[str, Callable]:
+    """解析渲染映射参数"""
+    field_mapper = {}
+    if not render_args:
+        return field_mapper
+
+    for mapping in render_args:
+        if "=" not in mapping:
+            console.print(f"[yellow]Warning: Invalid mapping format '{mapping}', expected 'renderer=field1,field2'[/yellow]")
+            continue
+
+        renderer_name, fields_str = mapping.split("=", 1)
+        renderer = get_renderer(renderer_name.strip())
+
+        if renderer is None:
+            console.print(f"[yellow]Warning: Unknown renderer '{renderer_name}'[/yellow]")
+
+            # 尝试给出建议
+            all_names = get_all_renderer_names()
+            suggestions = [name for name in all_names if renderer_name.lower() in name.lower()]
+            if suggestions:
+                console.print(f"[dim]Did you mean: {', '.join(suggestions[:3])}?[/dim]")
+            console.print(f"[dim]Use --list-renderers to see all available options[/dim]")
+            continue
+
+        for field in fields_str.split(","):
+            field = field.strip()
+            if field:
+                field_mapper[field] = renderer
+                console.print(f"[green]✓[/green] Mapped '{field}' → {renderer_name}")
+
+    return field_mapper
+
+
+def print_available_renderers():
+    """打印所有可用的渲染器"""
+    renderers = list_renderers()
+
+    if not renderers:
+        console.print("[yellow]No renderers available[/yellow]")
+        return
+
+    table = Table(title="Available Renderers", show_header=True, header_style="bold magenta")
+    table.add_column("Renderer", style="cyan", no_wrap=True)
+    table.add_column("Source", style="yellow", width=12)
+    table.add_column("Aliases", style="dim")
+    table.add_column("Description", style="green")
+
+    # 按来源分组排序
+    builtin_renderers = []
+    plugin_renderers = []
+
+    for name, info in renderers.items():
+        if info.source == "builtin":
+            builtin_renderers.append((name, info))
+        else:
+            plugin_renderers.append((name, info))
+
+    # 先显示内置，再显示插件
+    for name, info in sorted(builtin_renderers) + sorted(plugin_renderers):
+        source = info.source
+        if info.plugin_name:
+            source = f"📦 {info.plugin_name}"
+
+        aliases = ", ".join(info.aliases) if info.aliases else "-"
+        desc = info.description or "-"
+
+        table.add_row(name, source, aliases, desc)
+
+    console.print(table)
+    console.print("\n[bold]Usage:[/bold] seejx data.jsonl -r [cyan]<renderer>[/cyan]=[green]<field1>[/green],[green]<field2>[/green]...")
+    console.print("[bold]Example:[/bold] seejx data.jsonl -r messages=chat,conversation")