llm-prettier 0.1.1__tar.gz

llm_prettier-0.1.1/.gitignore

@@ -0,0 +1,30 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Generated viewer files
+viewer_*.html
+
+# IDE / editor
+.vscode/
+.idea/
+*.swp
+*.swo
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/

llm_prettier-0.1.1/LICENSE

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

llm_prettier-0.1.1/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: llm-prettier
+Version: 0.1.1
+Summary: A generic JSON prettier and interactive HTML viewer, built especially for parsing embedded JSON from LLM payloads and responses.
+Project-URL: Homepage, https://github.com/amaruki/llm-prettier
+Project-URL: Repository, https://github.com/amaruki/llm-prettier
+Project-URL: Issues, https://github.com/amaruki/llm-prettier/issues
+Author-email: Amaruki <krilinamar@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Amaruki
+        
+        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.
+License-File: LICENSE
+Keywords: ai,anthropic,debug,gemini,json,llm,openai,prettier,viewer
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# llm-prettier
+
+A simple, generic JSON prettier and interactive HTML viewer with a killer feature for developers working with LLM APIs: it automatically detects and parses **embedded stringified JSON**, rendering it as a full interactive tree rather than a raw escaped string.
+
+## Features
+
+- 🌲 **Interactive tree view** — Collapsible nodes for any JSON structure
+- 🔍 **Search & filter** — `Ctrl+F` search that highlights matching keys/values with `Enter`/`Shift+Enter` navigation
+- 📋 **Copy to clipboard** — Hover any value or key to copy it; click any key to copy its full JSON path
+- 🗺️ **JSON path breadcrumb** — Displays the full path (e.g. `$.choices[0].message.content`) on key click
+- 📊 **Stats bar** — Shows total key count, max depth, and data size at a glance
+- 🔢 **Depth controls** — Collapse to depth D2, D3, D4 in addition to expand/collapse all
+- 🪡 **Embedded JSON parsing** — Automatically detects and renders stringified JSON, including JSON inside Markdown code blocks (`json ... `) and XML tags (`<tool_call> ... </tool_call>`)
+- 💡 **Fully local** — No external dependencies; everything runs in-browser from a single HTML file
+
+## Installation
+
+Using `pip`:
+
+```bash
+pip install llm-prettier
+```
+
+Using `uv` (faster):
+
+```bash
+uv pip install llm-prettier
+```
+
+After installing, the `llm-prettier` CLI will be available.
+
+## Usage
+
+### CLI Tool
+
+```bash
+# Prettify a JSON file (saves as viewer_<name>.html)
+llm-prettier path/to/response.json
+
+# Open in browser immediately via local server
+llm-prettier path/to/response.json --serve
+
+# Specify custom output file
+llm-prettier path/to/response.json -o my_output.html
+
+# Read from stdin
+cat response.json | llm-prettier -
+curl https://api.example.com/data | llm-prettier - --serve
+
+# Custom server port
+llm-prettier response.json --serve --port 8080
+
+# Print version
+llm-prettier --version
+
+# Run it without installing globally
+uv run llm-prettier response.json --serve
+```
+
+### Python API
+
+```python
+import llm_prettier
+
+my_data = {
+    "model": "gemini-flash",
+    "message": {
+        "content": "{\"tool_call\": {\"temperature\": 0.8}}"
+    }
+}
+
+# Generate HTML string
+html_str = llm_prettier.render_html(my_data, title="My LLM Response")
+
+# Save to file; returns the absolute path on success
+out_path = llm_prettier.show(my_data, out_name="viewer_mydata.html")
+```
+
+## Viewer Keyboard Shortcuts
+
+| Key           | Action                |
+| ------------- | --------------------- |
+| `Ctrl+F`      | Focus search bar      |
+| `Enter`       | Next search match     |
+| `Shift+Enter` | Previous search match |
+| `Escape`      | Clear search          |
+
+## License
+
+[MIT](LICENSE)

llm_prettier-0.1.1/README.md

@@ -0,0 +1,90 @@
+# llm-prettier
+
+A simple, generic JSON prettier and interactive HTML viewer with a killer feature for developers working with LLM APIs: it automatically detects and parses **embedded stringified JSON**, rendering it as a full interactive tree rather than a raw escaped string.
+
+## Features
+
+- 🌲 **Interactive tree view** — Collapsible nodes for any JSON structure
+- 🔍 **Search & filter** — `Ctrl+F` search that highlights matching keys/values with `Enter`/`Shift+Enter` navigation
+- 📋 **Copy to clipboard** — Hover any value or key to copy it; click any key to copy its full JSON path
+- 🗺️ **JSON path breadcrumb** — Displays the full path (e.g. `$.choices[0].message.content`) on key click
+- 📊 **Stats bar** — Shows total key count, max depth, and data size at a glance
+- 🔢 **Depth controls** — Collapse to depth D2, D3, D4 in addition to expand/collapse all
+- 🪡 **Embedded JSON parsing** — Automatically detects and renders stringified JSON, including JSON inside Markdown code blocks (`json ... `) and XML tags (`<tool_call> ... </tool_call>`)
+- 💡 **Fully local** — No external dependencies; everything runs in-browser from a single HTML file
+
+## Installation
+
+Using `pip`:
+
+```bash
+pip install llm-prettier
+```
+
+Using `uv` (faster):
+
+```bash
+uv pip install llm-prettier
+```
+
+After installing, the `llm-prettier` CLI will be available.
+
+## Usage
+
+### CLI Tool
+
+```bash
+# Prettify a JSON file (saves as viewer_<name>.html)
+llm-prettier path/to/response.json
+
+# Open in browser immediately via local server
+llm-prettier path/to/response.json --serve
+
+# Specify custom output file
+llm-prettier path/to/response.json -o my_output.html
+
+# Read from stdin
+cat response.json | llm-prettier -
+curl https://api.example.com/data | llm-prettier - --serve
+
+# Custom server port
+llm-prettier response.json --serve --port 8080
+
+# Print version
+llm-prettier --version
+
+# Run it without installing globally
+uv run llm-prettier response.json --serve
+```
+
+### Python API
+
+```python
+import llm_prettier
+
+my_data = {
+    "model": "gemini-flash",
+    "message": {
+        "content": "{\"tool_call\": {\"temperature\": 0.8}}"
+    }
+}
+
+# Generate HTML string
+html_str = llm_prettier.render_html(my_data, title="My LLM Response")
+
+# Save to file; returns the absolute path on success
+out_path = llm_prettier.show(my_data, out_name="viewer_mydata.html")
+```
+
+## Viewer Keyboard Shortcuts
+
+| Key           | Action                |
+| ------------- | --------------------- |
+| `Ctrl+F`      | Focus search bar      |
+| `Enter`       | Next search match     |
+| `Shift+Enter` | Previous search match |
+| `Escape`      | Clear search          |
+
+## License
+
+[MIT](LICENSE)

llm_prettier-0.1.1/llm_prettier/__init__.py

@@ -0,0 +1,57 @@
+"""llm-prettier: A JSON prettier and interactive HTML viewer for LLM payloads."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+import llm_prettier.core as core
+
+__version__ = "0.1.0"
+__all__ = ["render_html", "show", "__version__"]
+
+
+def render_html(data: Any, title: str = "LLM Prettier Output") -> str:
+    """
+    Renders the provided dictionary/JSON data to a prettified interactive HTML tree.
+
+    Args:
+        data: The dictionary, list, or other JSON-serializable value to render.
+        title: The title shown in the browser tab and page header.
+
+    Returns:
+        A string containing the full HTML document.
+    """
+    return core.build_template(data, title)
+
+
+def show(
+    data: Any,
+    out_name: str = "viewer_output.html",
+    title: Optional[str] = None,
+) -> Optional[str]:
+    """
+    Renders the JSON data to an interactive HTML file and saves it to disk.
+
+    Args:
+        data: The dictionary or list to render.
+        out_name: The output filename. Default is 'viewer_output.html'.
+        title: The title of the HTML page. If None, derived from out_name.
+
+    Returns:
+        The absolute path to the written file on success, or None on failure.
+    """
+    import os
+
+    if title is None:
+        title = out_name
+
+    html = render_html(data, title)
+    try:
+        with open(out_name, "w", encoding="utf-8") as f:
+            f.write(html)
+        abs_path = os.path.abspath(out_name)
+        print(f"[SUCCESS] Generated {abs_path}")
+        return abs_path
+    except Exception as e:
+        print(f"[ERROR] Could not save {out_name}: {e}")
+        return None

llm_prettier-0.1.1/llm_prettier/assets/__init__.py

@@ -0,0 +1,2 @@
+"""Asset loader for llm-prettier."""
+# Ensure the assets directory is treated as a package by Python