scrollback 0.1.0__tar.gz → 0.1.1__tar.gz

{scrollback-0.1.0 → scrollback-0.1.1}/CHANGELOG.md

@@ -6,6 +6,14 @@ follow [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.1.1] - 2026-06-30
+
+### Fixed
+
+- README images now render on PyPI: use absolute, release-pinned PNG URLs
+  (PyPI does not resolve relative paths or display SVGs). Adds a PyPI-
+  friendly `cli.png` alongside the GitHub SVG.
+
 ## [0.1.0] - 2026-06-30
 
 The first release. scrollback reads AI coding-agent session history
@@ -82,5 +90,6 @@ export it from a CLI and a local web app.
 - Negative pagination arguments are rejected; clearer errors for unknown
   sources, failed exports, and unavailable data sources.
 
-[Unreleased]: https://github.com/a-attia/scrollback/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/a-attia/scrollback/compare/v0.1.1...HEAD
+[0.1.1]: https://github.com/a-attia/scrollback/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/a-attia/scrollback/releases/tag/v0.1.0

{scrollback-0.1.0 → scrollback-0.1.1}/CONTRIBUTING.md

@@ -55,12 +55,16 @@ publish. To regenerate them after a UI change:
 ```bash
 pip install -e ".[screenshots]"
 playwright install chromium       # one-time headless-browser download
-python scripts/screenshots.py     # writes assets/screenshots/{cli.svg,web.png}
+python scripts/screenshots.py     # writes assets/screenshots/{cli.svg,cli.png,web.png}
 ```
 
-The CLI image is rendered with `rich` (no browser); the web image is
-captured with headless Chromium via Playwright. Neither the `screenshots`
-extra nor the browser is needed to run scrollback.
+The CLI image is rendered with `rich` (SVG for GitHub, plus a PNG for PyPI,
+which does not display SVGs); the web image is captured with headless
+Chromium via Playwright. The README embeds the PNGs via absolute,
+release-pinned `raw.githubusercontent.com` URLs so they render on both
+GitHub and PyPI (relative paths only work on GitHub). When cutting a new
+release, bump the version in those URLs. Neither the `screenshots` extra nor
+the browser is needed to run scrollback.
 
 ## Submitting changes
 

{scrollback-0.1.0 → scrollback-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scrollback
-Version: 0.1.0
+Version: 0.1.1
 Summary: Navigate, search, copy, and export your AI coding-agent sessions (opencode, Claude Code, ...) from one local, read-only tool.
 Project-URL: Homepage, https://github.com/a-attia/scrollback
 Project-URL: Repository, https://github.com/a-attia/scrollback
@@ -73,13 +73,13 @@ modifies, locks for writing, or uploads your data.
 You can use it two ways. From the **command line**, list, search, and export
 your sessions in a single scriptable tool:
 
-![scrollback listing recent sessions in the terminal.](assets/screenshots/cli.svg)
+![scrollback listing recent sessions in the terminal.](https://raw.githubusercontent.com/a-attia/scrollback/v0.1.1/assets/screenshots/cli.png)
 
 Or open the **local web app** to read a transcript in full — with rendered
 Markdown, syntax-highlighted code, and typeset LaTeX math:
 
 ![The scrollback web app showing a session list beside a transcript with
-rendered Markdown, highlighted code, and typeset equations.](assets/screenshots/web.png)
+rendered Markdown, highlighted code, and typeset equations.](https://raw.githubusercontent.com/a-attia/scrollback/v0.1.1/assets/screenshots/web.png)
 
 Both views read the same on-disk session stores, so you can jump between
 them freely. (The screenshots above use synthetic demo data.)

{scrollback-0.1.0 → scrollback-0.1.1}/README.md

@@ -14,13 +14,13 @@ modifies, locks for writing, or uploads your data.
 You can use it two ways. From the **command line**, list, search, and export
 your sessions in a single scriptable tool:
 
-![scrollback listing recent sessions in the terminal.](assets/screenshots/cli.svg)
+![scrollback listing recent sessions in the terminal.](https://raw.githubusercontent.com/a-attia/scrollback/v0.1.1/assets/screenshots/cli.png)
 
 Or open the **local web app** to read a transcript in full — with rendered
 Markdown, syntax-highlighted code, and typeset LaTeX math:
 
 ![The scrollback web app showing a session list beside a transcript with
-rendered Markdown, highlighted code, and typeset equations.](assets/screenshots/web.png)
+rendered Markdown, highlighted code, and typeset equations.](https://raw.githubusercontent.com/a-attia/scrollback/v0.1.1/assets/screenshots/web.png)
 
 Both views read the same on-disk session stores, so you can jump between
 them freely. (The screenshots above use synthetic demo data.)

scrollback-0.1.1/assets/screenshots/cli.svg

@@ -0,0 +1,58 @@
+<svg class="rich-terminal" viewBox="0 0 1141 74.4" xmlns="http://www.w3.org/2000/svg">
+    <!-- Generated with Rich https://www.textualize.io -->
+    <style>
+
+    @font-face {
+        font-family: "Fira Code";
+        src: local("FiraCode-Regular"),
+                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff2/FiraCode-Regular.woff2") format("woff2"),
+                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff/FiraCode-Regular.woff") format("woff");
+        font-style: normal;
+        font-weight: 400;
+    }
+    @font-face {
+        font-family: "Fira Code";
+        src: local("FiraCode-Bold"),
+                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff2/FiraCode-Bold.woff2") format("woff2"),
+                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff/FiraCode-Bold.woff") format("woff");
+        font-style: bold;
+        font-weight: 700;
+    }
+
+    .terminal-387712033-matrix {
+        font-family: Fira Code, monospace;
+        font-size: 20px;
+        line-height: 24.4px;
+        font-variant-east-asian: full-width;
+    }
+
+    .terminal-387712033-title {
+        font-size: 18px;
+        font-weight: bold;
+        font-family: arial;
+    }
+
+    
+    </style>
+
+    <defs>
+    <clipPath id="terminal-387712033-clip-terminal">
+      <rect x="0" y="0" width="1121.3999999999999" height="23.4" />
+    </clipPath>
+    
+    </defs>
+
+    <rect fill="#292929" stroke="rgba(255,255,255,0.35)" stroke-width="1" x="1" y="1" width="1139" height="72.4" rx="8"/><text class="terminal-387712033-title" fill="#c5c8c6" text-anchor="middle" x="569" y="27">scrollback</text>
+            <g transform="translate(26,22)">
+            <circle cx="0" cy="0" r="7" fill="#ff5f57"/>
+            <circle cx="22" cy="0" r="7" fill="#febc2e"/>
+            <circle cx="44" cy="0" r="7" fill="#28c840"/>
+            </g>
+        
+    <g transform="translate(9, 41)" clip-path="url(#terminal-387712033-clip-terminal)">
+    
+    <g class="terminal-387712033-matrix">
+    
+    </g>
+    </g>
+</svg>

{scrollback-0.1.0 → scrollback-0.1.1}/scripts/screenshots.py

@@ -32,7 +32,12 @@ OUT.mkdir(parents=True, exist_ok=True)
 
 # -- CLI screenshot (rich -> SVG, no browser) ----------------------------
 
-def render_cli_svg() -> Path:
+def render_cli() -> list[Path]:
+    """Render the CLI list to SVG (crisp on GitHub) and PNG (for PyPI).
+
+    PyPI's README renderer does not display SVG images, so a PNG is needed
+    there; GitHub renders both, and SVG stays sharp at any zoom.
+    """
     from rich.console import Console
     from rich.table import Table
     from rich.text import Text
@@ -66,10 +71,45 @@ def render_cli_svg() -> Path:
 
     console.print(Text("$ scrollback list --usage", style="bold green"))
     console.print(table)
-    out = OUT / "cli.svg"
-    console.save_svg(str(out), title="scrollback")
-    print(f"wrote {out}")
-    return out
+
+    # PyPI-friendly PNG first: rich's save_svg() clears the record buffer, so
+    # the HTML export must happen before we write the SVG.
+    png_path = OUT / "cli.png"
+    try:
+        _svg_html_to_png(console, png_path)
+        print(f"wrote {png_path}")
+    except Exception as exc:  # noqa: BLE001
+        print(f"cli.png skipped: {exc}", file=sys.stderr)
+
+    svg_path = OUT / "cli.svg"
+    console.save_svg(str(svg_path), title="scrollback")
+    print(f"wrote {svg_path}")
+    return [png_path, svg_path]
+
+
+def _svg_html_to_png(console, out: Path) -> None:
+    from playwright.sync_api import sync_playwright
+
+    # rich returns a full HTML document; give it a dark terminal-like page and
+    # screenshot the <pre> block (which carries the real content dimensions).
+    html = console.export_html(
+        inline_styles=True,
+        code_format=(
+            "<!DOCTYPE html><html><head><meta charset='utf-8'>"
+            "<style>html,body{{margin:0}}"
+            "body{{background:#0d1117;display:inline-block;padding:22px 26px}}"
+            "pre{{margin:0;color:#c9d1d9;font:15px/1.5 Menlo,Consolas,monospace}}"
+            "</style></head>"
+            "<body><pre><code>{code}</code></pre></body></html>"
+        ),
+    )
+    with sync_playwright() as p:
+        browser = p.chromium.launch()
+        page = browser.new_page(device_scale_factor=2)
+        page.set_content(html, wait_until="load")
+        # The inline-block body wraps tightly around the terminal block.
+        page.query_selector("body").screenshot(path=str(out))
+        browser.close()
 
 
 # -- web screenshot (headless Chromium via Playwright) -------------------
@@ -132,7 +172,7 @@ def render_web_png() -> Path:
 
 
 def main() -> int:
-    render_cli_svg()
+    render_cli()
     try:
         render_web_png()
     except Exception as exc:  # noqa: BLE001

{scrollback-0.1.0 → scrollback-0.1.1}/src/scrollback/__init__.py

@@ -5,4 +5,4 @@ coding agents (opencode, Claude Code, ...) through a common adapter
 interface and lets you list, view, search, and export those sessions.
 """
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"

scrollback-0.1.0/assets/screenshots/cli.svg

@@ -1,91 +0,0 @@
-<svg class="rich-terminal" viewBox="0 0 1141 245.2" xmlns="http://www.w3.org/2000/svg">
-    <!-- Generated with Rich https://www.textualize.io -->
-    <style>
-
-    @font-face {
-        font-family: "Fira Code";
-        src: local("FiraCode-Regular"),
-                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff2/FiraCode-Regular.woff2") format("woff2"),
-                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff/FiraCode-Regular.woff") format("woff");
-        font-style: normal;
-        font-weight: 400;
-    }
-    @font-face {
-        font-family: "Fira Code";
-        src: local("FiraCode-Bold"),
-                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff2/FiraCode-Bold.woff2") format("woff2"),
-                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff/FiraCode-Bold.woff") format("woff");
-        font-style: bold;
-        font-weight: 700;
-    }
-
-    .terminal-4113685748-matrix {
-        font-family: Fira Code, monospace;
-        font-size: 20px;
-        line-height: 24.4px;
-        font-variant-east-asian: full-width;
-    }
-
-    .terminal-4113685748-title {
-        font-size: 18px;
-        font-weight: bold;
-        font-family: arial;
-    }
-
-    .terminal-4113685748-r1 { fill: #98a84b;font-weight: bold }
-.terminal-4113685748-r2 { fill: #c5c8c6 }
-.terminal-4113685748-r3 { fill: #c5c8c6;font-weight: bold }
-.terminal-4113685748-r4 { fill: #d0b344 }
-.terminal-4113685748-r5 { fill: #868887 }
-.terminal-4113685748-r6 { fill: #d75f00 }
-    </style>
-
-    <defs>
-    <clipPath id="terminal-4113685748-clip-terminal">
-      <rect x="0" y="0" width="1121.3999999999999" height="194.2" />
-    </clipPath>
-    <clipPath id="terminal-4113685748-line-0">
-    <rect x="0" y="1.5" width="1122.4" height="24.65"/>
-            </clipPath>
-<clipPath id="terminal-4113685748-line-1">
-    <rect x="0" y="25.9" width="1122.4" height="24.65"/>
-            </clipPath>
-<clipPath id="terminal-4113685748-line-2">
-    <rect x="0" y="50.3" width="1122.4" height="24.65"/>
-            </clipPath>
-<clipPath id="terminal-4113685748-line-3">
-    <rect x="0" y="74.7" width="1122.4" height="24.65"/>
-            </clipPath>
-<clipPath id="terminal-4113685748-line-4">
-    <rect x="0" y="99.1" width="1122.4" height="24.65"/>
-            </clipPath>
-<clipPath id="terminal-4113685748-line-5">
-    <rect x="0" y="123.5" width="1122.4" height="24.65"/>
-            </clipPath>
-<clipPath id="terminal-4113685748-line-6">
-    <rect x="0" y="147.9" width="1122.4" height="24.65"/>
-            </clipPath>
-    </defs>
-
-    <rect fill="#292929" stroke="rgba(255,255,255,0.35)" stroke-width="1" x="1" y="1" width="1139" height="243.2" rx="8"/><text class="terminal-4113685748-title" fill="#c5c8c6" text-anchor="middle" x="569" y="27">scrollback</text>
-            <g transform="translate(26,22)">
-            <circle cx="0" cy="0" r="7" fill="#ff5f57"/>
-            <circle cx="22" cy="0" r="7" fill="#febc2e"/>
-            <circle cx="44" cy="0" r="7" fill="#28c840"/>
-            </g>
-        
-    <g transform="translate(9, 41)" clip-path="url(#terminal-4113685748-clip-terminal)">
-    
-    <g class="terminal-4113685748-matrix">
-    <text class="terminal-4113685748-r1" x="0" y="20" textLength="305" clip-path="url(#terminal-4113685748-line-0)">$&#160;scrollback&#160;list&#160;--usage</text><text class="terminal-4113685748-r2" x="1122.4" y="20" textLength="12.2" clip-path="url(#terminal-4113685748-line-0)">
-</text><text class="terminal-4113685748-r3" x="0" y="44.4" textLength="122" clip-path="url(#terminal-4113685748-line-1)">source&#160;&#160;&#160;&#160;</text><text class="terminal-4113685748-r3" x="146.4" y="44.4" textLength="146.4" clip-path="url(#terminal-4113685748-line-1)">id&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="terminal-4113685748-r3" x="317.2" y="44.4" textLength="195.2" clip-path="url(#terminal-4113685748-line-1)">updated&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="terminal-4113685748-r3" x="536.8" y="44.4" textLength="48.8" clip-path="url(#terminal-4113685748-line-1)">msgs</text><text class="terminal-4113685748-r3" x="610" y="44.4" textLength="61" clip-path="url(#terminal-4113685748-line-1)">&#160;cost</text><text class="terminal-4113685748-r3" x="695.4" y="44.4" textLength="122" clip-path="url(#terminal-4113685748-line-1)">tok&#160;in/out</text><text class="terminal-4113685748-r3" x="841.8" y="44.4" textLength="280.6" clip-path="url(#terminal-4113685748-line-1)">title&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="terminal-4113685748-r2" x="1122.4" y="44.4" textLength="12.2" clip-path="url(#terminal-4113685748-line-1)">
-</text><text class="terminal-4113685748-r4" x="0" y="68.8" textLength="122" clip-path="url(#terminal-4113685748-line-2)">opencode&#160;&#160;</text><text class="terminal-4113685748-r5" x="146.4" y="68.8" textLength="146.4" clip-path="url(#terminal-4113685748-line-2)">ses_demo_hea</text><text class="terminal-4113685748-r5" x="317.2" y="68.8" textLength="195.2" clip-path="url(#terminal-4113685748-line-2)">2026-03-14&#160;09:32</text><text class="terminal-4113685748-r2" x="536.8" y="68.8" textLength="48.8" clip-path="url(#terminal-4113685748-line-2)">&#160;&#160;&#160;2</text><text class="terminal-4113685748-r2" x="610" y="68.8" textLength="61" clip-path="url(#terminal-4113685748-line-2)">$0.02</text><text class="terminal-4113685748-r2" x="695.4" y="68.8" textLength="122" clip-path="url(#terminal-4113685748-line-2)">&#160;1.8k/2.3k</text><text class="terminal-4113685748-r2" x="841.8" y="68.8" textLength="280.6" clip-path="url(#terminal-4113685748-line-2)">Derive&#160;a&#160;stable&#160;scheme&#160;</text><text class="terminal-4113685748-r2" x="1122.4" y="68.8" textLength="12.2" clip-path="url(#terminal-4113685748-line-2)">
-</text><text class="terminal-4113685748-r2" x="841.8" y="93.2" textLength="280.6" clip-path="url(#terminal-4113685748-line-3)">for&#160;the&#160;heat&#160;equation&#160;&#160;</text><text class="terminal-4113685748-r2" x="1122.4" y="93.2" textLength="12.2" clip-path="url(#terminal-4113685748-line-3)">
-</text><text class="terminal-4113685748-r6" x="0" y="117.6" textLength="122" clip-path="url(#terminal-4113685748-line-4)">claudecode</text><text class="terminal-4113685748-r5" x="146.4" y="117.6" textLength="146.4" clip-path="url(#terminal-4113685748-line-4)">ses_demo_ref</text><text class="terminal-4113685748-r5" x="317.2" y="117.6" textLength="195.2" clip-path="url(#terminal-4113685748-line-4)">2026-03-14&#160;08:10</text><text class="terminal-4113685748-r2" x="536.8" y="117.6" textLength="48.8" clip-path="url(#terminal-4113685748-line-4)">&#160;&#160;&#160;2</text><text class="terminal-4113685748-r2" x="610" y="117.6" textLength="61" clip-path="url(#terminal-4113685748-line-4)">$0.01</text><text class="terminal-4113685748-r2" x="695.4" y="117.6" textLength="122" clip-path="url(#terminal-4113685748-line-4)">&#160;&#160;1.2k/900</text><text class="terminal-4113685748-r2" x="841.8" y="117.6" textLength="280.6" clip-path="url(#terminal-4113685748-line-4)">Refactor&#160;load_config&#160;&#160;&#160;</text><text class="terminal-4113685748-r2" x="1122.4" y="117.6" textLength="12.2" clip-path="url(#terminal-4113685748-line-4)">
-</text><text class="terminal-4113685748-r2" x="841.8" y="142" textLength="280.6" clip-path="url(#terminal-4113685748-line-5)">with&#160;typed&#160;validation&#160;&#160;</text><text class="terminal-4113685748-r2" x="1122.4" y="142" textLength="12.2" clip-path="url(#terminal-4113685748-line-5)">
-</text><text class="terminal-4113685748-r4" x="0" y="166.4" textLength="122" clip-path="url(#terminal-4113685748-line-6)">opencode&#160;&#160;</text><text class="terminal-4113685748-r5" x="146.4" y="166.4" textLength="146.4" clip-path="url(#terminal-4113685748-line-6)">ses_demo_bug</text><text class="terminal-4113685748-r5" x="317.2" y="166.4" textLength="195.2" clip-path="url(#terminal-4113685748-line-6)">2026-03-13&#160;09:32</text><text class="terminal-4113685748-r2" x="536.8" y="166.4" textLength="48.8" clip-path="url(#terminal-4113685748-line-6)">&#160;&#160;&#160;2</text><text class="terminal-4113685748-r2" x="610" y="166.4" textLength="61" clip-path="url(#terminal-4113685748-line-6)">$0.01</text><text class="terminal-4113685748-r2" x="695.4" y="166.4" textLength="122" clip-path="url(#terminal-4113685748-line-6)">&#160;&#160;&#160;640/410</text><text class="terminal-4113685748-r2" x="841.8" y="166.4" textLength="280.6" clip-path="url(#terminal-4113685748-line-6)">Fix&#160;timezone-naive&#160;&#160;&#160;&#160;&#160;</text><text class="terminal-4113685748-r2" x="1122.4" y="166.4" textLength="12.2" clip-path="url(#terminal-4113685748-line-6)">
-</text><text class="terminal-4113685748-r2" x="841.8" y="190.8" textLength="280.6" clip-path="url(#terminal-4113685748-line-7)">timestamp&#160;crash&#160;in&#160;sort</text><text class="terminal-4113685748-r2" x="1122.4" y="190.8" textLength="12.2" clip-path="url(#terminal-4113685748-line-7)">
-</text>
-    </g>
-    </g>
-</svg>