viewinline 0.5.0__tar.gz → 0.5.1__tar.gz

viewinline-0.5.1/.gitignore

@@ -0,0 +1,5 @@
+__pycache__/
+.pytest_cache/
+dist/
+*.egg-info/
+.DS_Store

{viewinline-0.5.0 → viewinline-0.5.1}/CITATION.cff

@@ -19,8 +19,8 @@ authors:
 repository-code: "https://github.com/nkeikon/inlineviewer"
 url: "https://github.com/nkeikon/inlineviewer"
 license: Apache-2.0
-version: 0.5.0
-date-released: 2026-10-21
+version: 0.5.1
+date-released: 2026-11-10
 # ---------------------------------------------------------------------------
 # The DOI below is the VERSION DOI for v0.3.2 (a specific archived snapshot).
 # To make citations always resolve to your LATEST release, replace it with the

{viewinline-0.5.0 → viewinline-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: viewinline
-Version: 0.5.0
+Version: 0.5.1
 Summary: Quick look geospatial viewer for the terminal, with inline image previews
 Project-URL: Homepage, https://github.com/nkeikon/viewinline
 Project-URL: Repository, https://github.com/nkeikon/viewinline
@@ -109,6 +109,15 @@ viewinline counties.shp --table --unique STATE_NAME
 viewinline data.geoparquet --table --where "POP > 100000" --sort POP --desc
 ```
 
+## Use with Claude Code
+
+viewinline includes a skill that lets Claude Code inspect files with `--info` and offer quick-look previews with `--export`. To install:
+
+```
+mkdir -p ~/.claude/skills/viewinline
+curl -o ~/.claude/skills/viewinline/SKILL.md https://raw.githubusercontent.com/nkeikon/inlineviewer/main/skills/viewinline/SKILL.md
+```
+
 ## Compatible terminals
 
 Native (no extra install required): images render via the iTerm2 inline image protocol on:

{viewinline-0.5.0 → viewinline-0.5.1}/README.md

@@ -76,6 +76,15 @@ viewinline counties.shp --table --unique STATE_NAME
 viewinline data.geoparquet --table --where "POP > 100000" --sort POP --desc
 ```
 
+## Use with Claude Code
+
+viewinline includes a skill that lets Claude Code inspect files with `--info` and offer quick-look previews with `--export`. To install:
+
+```
+mkdir -p ~/.claude/skills/viewinline
+curl -o ~/.claude/skills/viewinline/SKILL.md https://raw.githubusercontent.com/nkeikon/inlineviewer/main/skills/viewinline/SKILL.md
+```
+
 ## Compatible terminals
 
 Native (no extra install required): images render via the iTerm2 inline image protocol on:

{viewinline-0.5.0 → viewinline-0.5.1}/context7.json

@@ -1,4 +1,3 @@
-```json
 {
   "$schema": "https://context7.com/schema/context7.json",
   "projectTitle": "viewinline",
@@ -14,7 +13,7 @@
     "Use inline terminal image rendering instead of GUI workflows.",
     "Highlight support for GeoTIFF, NetCDF, GeoJSON, and GeoParquet.",
     "Emphasize compatibility limitations for terminal graphics protocols.",
-    "For programmatic or AI-agent use, note --info (JSON metadata) and --export (save rendered image)."
+    "For programmatic or AI-agent use, note --info (JSON metadata) and --export (save rendered image).",
+    "For Claude Code users, mention the viewinline skill at skills/viewinline/SKILL.md and how to install it."
   ]
 }
-```

{viewinline-0.5.0 → viewinline-0.5.1}/llms.txt

@@ -7,7 +7,7 @@
 - Command name: `viewinline`
 - Requires: Python 3.9+
 - License: Apache-2.0 © 2026 Keiko Nomura
-- Latest release: v0.5.0 (2026-10-21)
+- Latest release: v0.5.1 (2026-11-10)
 - Combines the core display logic of `viewtif` and `viewgeom`, but is **non-interactive**: no zoom/pan/colormap-switching on the fly. Everything is controlled via CLI options (e.g. `--display`, `--color-by`, `--colormap`).
 
 ## Installation
@@ -24,6 +24,17 @@ Optional extras (install only if needed):
 - `h5py` — fallback for HDF5 if GDAL lacks HDF5 support (usually unnecessary). `pip install h5py`
 - `chafa` — system binary (not a Python package); strongly recommended for terminal coverage beyond the native list. See "Terminals".
 
+## Use with Claude Code
+
+viewinline has a Claude Code skill. It is a separate install from the pip package:
+
+```
+mkdir -p ~/.claude/skills/viewinline
+curl -o ~/.claude/skills/viewinline/SKILL.md https://raw.githubusercontent.com/nkeikon/inlineviewer/main/skills/viewinline/SKILL.md
+```
+
+Start a new Claude Code session after installing. The skill is at skills/viewinline/SKILL.md in the GitHub repository.
+
 ## How display works (rendering engines)
 
 - Uses the **iTerm2 inline image protocol (OSC 1337)** natively in supported terminals.
@@ -239,6 +250,7 @@ Optional: `chafa` (terminal coverage; system binary), `duckdb` (filter/sort/SQL)
 - **v0.1.5 (2026-02-13):** Fixed duplicate band-display prints; optimized uint8 normalization; minor perf.
 - **v0.4.0 (2026-08-23):** New agent-facing inspection commands: `--info` (file metadata + statistics as JSON, for rasters and vectors; lists variables for NetCDF/HDF with `--subset`; always returns JSON including structured errors) and `--export` (save the rendered image to PNG/JPEG, works with any display flag). Existing viewer behavior unchanged.
 - **v0.5.0 (2026-10-21):** New `--grid [N]` flag: axis ticks and a light grid overlay. Georeferenced rasters and vectors are labelled in real CRS coordinates; photos, NetCDF, and non-georeferenced files in pixel positions. Grid contributed by @luismanriqueruiz.
+- **v0.5.1 (2026-11-10):** Bug fix: viewinline now exits with code 1 (instead of 0) when an input file is missing or unreadable — PNG/JPG, GeoTIFF, vectors (.shp, .geojson, .gpkg), and NetCDF — so scripts and agents can detect the failure. Missing PNG/JPG fix contributed by @Qrytics (#8).
 
 ## Support & links
 

{viewinline-0.5.0 → viewinline-0.5.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "viewinline"
-version = "0.5.0"
+version = "0.5.1"
 description = "Quick look geospatial viewer for the terminal, with inline image previews"
 readme = "README.md"
 license = { text = "Apache-2.0" }

{viewinline-0.5.0 → viewinline-0.5.1/skills}/viewinline/SKILL.md

@@ -10,6 +10,15 @@ Quick-look terminal viewer for geospatial and tabular data. Think of it as `ls`
 
 Renders natively in iTerm2, WezTerm, Konsole, Rio, and Contour. Falls back to `chafa` (ASCII art with 24-bit color) in other terminals like kitty, Ghostty, Terminal.app, VS Code, and Linux terminals. Works over SSH without X11 forwarding or VNC.
 
+## Inside Claude Code
+
+To show the user an image, use `--export`. It saves a PNG and opens it in the user's default image viewer, and you can read the same PNG. Ask before running it, e.g. "Want to see a quick-look of `ndvi.tif`?" If the user asks to see a file, run it directly. If they say to always or never show images, follow that for the rest of the session.
+
+- Use `--info` freely for your own checks. It prints JSON and opens nothing.
+- A plain `viewinline file.tif` run from the shell does not reach the user, because the output is captured as text. Don't claim you showed them an image that way.
+- CSV and Parquet previews with more than 10 rows ask `[first/all]`. Pipe the answer in: `echo first | viewinline data.csv`.
+- Delete exported PNGs once they're no longer needed, unless the user wants to keep them.
+
 ## When to Use
 
 - **File browsing**: `find . -name "*.jpg" | xargs -n1 viewinline` to visually scan results
@@ -59,9 +68,9 @@ Note: `--info` and `--export` report what a file *is* and what it *looks like*
 
 ## Core Flags
 
-**Inspection (JSON output, no image):**
+**Inspection:**
 - `--info` — print metadata + statistics as JSON, then exit (rasters and vectors; lists variables for NetCDF/HDF with `--subset N`)
-- `--export PATH` — save the rendered image to PATH (`.png`/`.jpg`); prints `{"path": "..."}`
+- `--export PATH` — save the rendered image to PATH (`.png`/`.jpg`), open it in the default image viewer, and print `{"path": "..."}`
 - `--grid [N]` — overlay axis ticks and a light grid (N divisions, default 5). Labels are in the file's CRS units for georeferenced rasters and vectors, pixel positions otherwise. Combine with `--export` to save a quick-look with readable coordinates, e.g. to check a file covers the expected area.
 
 **Raster Display:**

{viewinline-0.5.0 → viewinline-0.5.1}/src/viewinline/viewinline.py

@@ -35,7 +35,7 @@ warnings.filterwarnings("ignore", message="invalid scale_factor or add_offset at
 _EXPORT_PATH = None
 _EXPORT_RESULT = None
 
-__version__ = "0.5.0"
+__version__ = "0.5.1"
 
 AVAILABLE_COLORMAPS = [
     "viridis", "inferno", "magma", "plasma",
@@ -1068,6 +1068,11 @@ def render_simple_image(filepath: str, args) -> None:
 
         show_image_auto(img_array, getattr(args, "display", None), is_vector=False)
         
+    except FileNotFoundError:
+        # A missing file is not a damaged-but-readable image: let the
+        # caller report it with a nonzero exit instead of falling back
+        # to the rasterio path.
+        raise
     except Exception as e:
         print(f"[ERROR] Failed to load image: {e}")
 
@@ -1087,7 +1092,7 @@ def render_netcdf_via_netcdf4(path, args):
         nc = netCDF4.Dataset(path)
     except Exception as e:
         print(f"[ERROR] Could not open NetCDF file: {e}")
-        return
+        sys.exit(1)
 
     # Recursively collect (path, variable) pairs across all groups
     def collect_vars(group, prefix=""):
@@ -1536,6 +1541,7 @@ def render_raster(paths: list[str], args) -> None:
             print("[INFO] viewinline only supports 2D or 3D NetCDF variables")
         else:
             print(f"[ERROR] Inline render failed: {e}")
+        sys.exit(1)
 
 
 def render_gallery(folder: str, grid: str = "4x4", display_scale=None, is_vector=False) -> None:
@@ -1750,7 +1756,7 @@ def render_vector(path, args):
         return
     except Exception as e:
         print(f"[ERROR] Failed to read vector: {e}")
-        return
+        sys.exit(1)
         
     # Detect non-geometry columns
     all_cols = [c for c in gdf.columns if c != gdf.geometry.name]
@@ -2292,6 +2298,9 @@ def main() -> None:
                 try:
                     render_simple_image(paths[0], args)
                     return
+                except FileNotFoundError as e:
+                    print(f"[ERROR] Failed to read file: {e}")
+                    sys.exit(1)
                 except Exception:
                     pass
             render_raster(paths, args)

viewinline-0.5.1/tests/test_missing_image.py

@@ -0,0 +1,39 @@
+"""A missing PNG/JPG must exit nonzero, not report an error with exit 0."""
+
+import sys
+
+import pytest
+
+from viewinline.viewinline import main
+
+
+def _run(argv, capsys):
+    sys.argv = argv
+    with pytest.raises(SystemExit) as exc:
+        main()
+    out = capsys.readouterr().out
+    return exc.value.code, out
+
+
+def test_missing_png_exits_nonzero(capsys):
+    code, out = _run(["viewinline", "/nonexistent-xyz-440.png"], capsys)
+    assert code == 1
+    assert "[ERROR]" in out
+
+
+def test_missing_jpg_exits_nonzero(capsys):
+    code, out = _run(["viewinline", "/nonexistent-xyz-440.jpg"], capsys)
+    assert code == 1
+    assert "[ERROR]" in out
+
+
+@pytest.mark.parametrize("path", [
+    "/nonexistent-xyz-440.tif",
+    "/nonexistent-xyz-440.shp",
+    "/nonexistent-xyz-440.geojson",
+    "/nonexistent-xyz-440.nc",
+])
+def test_missing_raster_or_vector_exits_nonzero(path, capsys):
+    code, out = _run(["viewinline", path], capsys)
+    assert code == 1
+    assert "[ERROR]" in out

viewinline-0.5.0/.gitignore

@@ -1,4 +0,0 @@
-dist/
-build/
-*.egg-info
-*.DS_Store