PyPI - viewinline - Versions diffs - 0.2.0__tar.gz → 0.2.1__tar.gz - Mend

viewinline 0.2.0tar.gz → 0.2.1tar.gz

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 (8) hide show

{viewinline-0.2.0 → viewinline-0.2.1}/LICENSE RENAMED Viewed

@@ -1,4 +1,4 @@
-Copyright 2025 Keiko Nomura
+Copyright 2026 Keiko Nomura
                                  Apache License
                            Version 2.0, January 2004

{viewinline-0.2.0 → viewinline-0.2.1}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: viewinline
-Version: 0.2.0
+Version: 0.2.1
 Summary: Quick look geospatial viewer for iTerm2 compatible terminals
 Project-URL: Homepage, https://github.com/nkeikon/viewinline
 Project-URL: Repository, https://github.com/nkeikon/viewinline
@@ -12,9 +12,18 @@ Requires-Python: >=3.9
 Requires-Dist: geopandas
 Requires-Dist: matplotlib
 Requires-Dist: numpy
+Requires-Dist: pandas
 Requires-Dist: pillow
 Requires-Dist: pyogrio
 Requires-Dist: rasterio
+Provides-Extra: all
+Requires-Dist: duckdb; extra == 'all'
+Requires-Dist: h5py; extra == 'all'
+Requires-Dist: pyarrow; extra == 'all'
+Provides-Extra: hdf5
+Requires-Dist: h5py; extra == 'hdf5'
+Provides-Extra: parquet
+Requires-Dist: pyarrow; extra == 'parquet'
 Provides-Extra: sql
 Requires-Dist: duckdb; extra == 'sql'
 Description-Content-Type: text/markdown
@@ -25,10 +34,12 @@ Description-Content-Type: text/markdown
 [![Python version](https://img.shields.io/badge/python-%3E%3D3.9-blue.svg)](https://pypi.org/project/viewinline/)
 **Quick-look geospatial viewer for compatible terminals.**
-Displays rasters, vectors, and CSV data directly in the terminal with no GUI and no temporary files.
+Displays rasters, vectors, and tabular data directly in the terminal with no GUI and no temporary files.
 Think of it as `ls` for geospatial files — designed for quick visual inspection at the command line, not a replacement for QGIS, ArcGIS, or analytical workflows.
+Particularly useful on HPC systems and remote servers accessed via SSH. Images render on your local terminal without X11 forwarding, VNC, or file downloads.
 This tool combines the core display logic of `viewtif` and `viewgeom`, but is **non-interactive**: you can't zoom, pan, or switch colormaps on the fly. Instead, you control everything through command-line options (e.g. --display, --color-by, --colormap).
 It uses the iTerm2 inline image protocol (OSC 1337) to render previews. In incompatible terminals, the escape codes are silently ignored with no errors or crashes.
@@ -42,77 +53,130 @@ pip install viewinline
 ## Usage
 ```bash
+# Rasters
 viewinline path/to/file.tif
-viewinline path/to/vector.geojson
-viewinline R.tif G.tif B.tif                 # RGB composite
-viewinline path/to/multiband.tif --rgb-bands 3,2,1
+viewinline R.tif G.tif B.tif                 # RGB composite (also works with --rgbfiles)
+viewinline path/to/multiband.tif --rgb 3 2 1
 viewinline path/to/folder --gallery 4x3      # show image gallery (e.g. 4x3 grid)
+# NetCDF and HDF
+viewinline file.nc                           # list variables
+viewinline file.nc --subset 2                # display variable 2
+viewinline file.nc --subset 1 --band 10      # variable 1, timestep 10 --band or --timestep
+viewinline temp.nc --subset 1 --colormap plasma --vmin 273 --vmax 310
+# Vectors
+viewinline path/to/vector.geojson
+viewinline boundaries.geoparquet --color-by population --colormap viridis
+# CSV and Parquet
 viewinline data.csv                          # preview rows and columns
-viewinline data.csv --describe               # summary statistics for all numeric columns
-viewinline data.csv --describe Income        # summary statistics for one column
+viewinline data.parquet --describe           # summary statistics
 viewinline data.csv --hist                   # histograms for all numeric columns
 viewinline data.csv --hist area_km2          # histogram for one column
 viewinline data.csv --scatter X Y            # scatter plot
 viewinline data.csv --where "year > 2010"    # filter rows
-viewinline data.csv --sort population        # sort rows
+viewinline data.csv --sort population --desc # sort rows
 viewinline data.csv --sql "SELECT * FROM data WHERE area > 100 ORDER BY year"  # full SQL
+# Tabular view of vectors
+viewinline counties.shp --table              # view shapefile as table
+viewinline counties.shp --table --describe   # summary statistics
+viewinline counties.shp --table --unique STATE_NAME
+viewinline data.geoparquet --table --where "POP > 100000" --sort POP --desc
 ```
 ## Compatible terminals
-The iTerm2 inline image protocol is supported by:
+The iTerm2 inline image protocol (OSC 1337) is supported by:
 - **iTerm2** (macOS)
 - **WezTerm** (cross-platform)
 - **Konsole** (Linux/KDE)
-- **Rio**, **Contour** (Linux)
+- **Rio**, **Contour** (cross-platform)
+**Not compatible:** Mac Terminal, GNOME Terminal, Kitty (uses different protocol), Ghostty, Alacritty
-Not supported: Mac Terminal, GNOME Terminal, Kitty, Ghostty, Alacritty.
+**SSH/HPC usage:** Works over SSH when connecting from a compatible terminal. Images render on your local machine, not the remote server. No X11 forwarding or VNC required.
-> **Note:** Does not work inside tmux or screen.
+**tmux/screen:** Inline images don't work inside tmux or screen sessions, even with `allow-passthrough on`. Use a plain terminal tab.
 ## Features
-- Previews rasters, vectors and CSV files directly in the terminal
-- Non-interactive: everything is controlled through command-line options
+- Previews rasters, vectors, and tabular data directly in the terminal
+- Non-interactive: everything is controlled through command-line options
+- **NetCDF/HDF Support:** Display variables from NetCDF (.nc) and HDF5 (.h5, .hdf5) files with automatic nodata detection and multi-slice navigation
+- **Parquet/GeoParquet:** Render GeoParquet as vector maps or view as tabular data
+- **Tabular View for Vectors:** Use `--table` to access CSV-style operations (filter, sort, describe, hist) on any vector file
 ## Supported formats
 **Rasters**
 - GeoTIFF (.tif, .tiff)
 - PNG, JPEG (.png, .jpg, .jpeg)
+- NetCDF (.nc)
+- HDF5 (.h5, .hdf5)
+- HDF4 (.hdf) — requires GDAL with HDF4 support
 - Single-band or multi-band composites
 **Composite inputs**
-- You can pass three rasters (e.g. `R.tif G.tif B.tif`) to create an RGB composite
+- You can pass three rasters (e.g. `R.tif G.tif B.tif`) or use `--rgbfiles R.tif G.tif B.tif` to create an RGB composite
+- Multi-band files: use `--rgb 3 2 1` to specify band order
 **Vectors**
 - GeoJSON (`.geojson`)
-- Shapefile (`.shp`, `.dbf`, `.shx`)
-- GeoPackage (`.gpkg`)
-**CSV**
+- Shapefile (`.shp`)
+- GeoPackage (`.gpkg`)
+- Parquet/GeoParquet (`.parquet`, `.geoparquet`)
+**Tabular data (CSV and Parquet)**
+- CSV (`.csv`)
+- Parquet (`.parquet`) — requires `pyarrow`
+- All CSV operations work on parquet files
 - Preview file summary (rows, columns, and names)
 - Summary statistics with `--describe`
-- Show all numeric columns, or specify one (e.g. `--describe height`)
 - Inline histograms with `--hist`
-- Show all numeric columns, or specify one (e.g. `--hist area_km2`)
 - Scatter plots with `--scatter X Y`
 - Filter rows with `--where`, sort with `--sort`, limit output with `--limit`
-- Full SQL queries with `--sql` (DuckDB required) — use `data` as the table name (e.g. `--sql "SELECT State, AVG(Income) FROM data GROUP BY State"`)
+- Full SQL queries with `--sql` (DuckDB required) — use `data` as the table name
+**Tabular view of vectors**
+- Use `--table` flag to view any vector file (shapefiles, GeoPackage, GeoParquet) as tabular data
+- Enables all CSV-style operations: `--describe`, `--hist`, `--scatter`, `--unique`, `--where`, `--sort`
 **Gallery view**
 - Display all images in a folder with `--gallery 4x4`
+**NetCDF/HDF notes:**
+- viewinline lists only variables that can be displayed as 2D or 3D arrays
+- Variables with additional dimensions (e.g., vertical levels) may be listed but will fail to display with a clear error message
+- For a complete variable list, use `ncdump -h file.nc` or `viewtif`
 ## Dependencies
-Core dependencies (installed automatically):
-- `rasterio` — raster reading
+**Core dependencies** (installed automatically):
+- `rasterio` — raster reading (includes GDAL)
 - `geopandas`, `pyogrio` — vector reading
 - `matplotlib` — vector rendering
 - `Pillow` — image encoding
 - `numpy`, `pandas` — data handling
-Optional:
-- `duckdb` — required for `--where`, `--sort`, `--sql`, and `--limit` with filtering. Install separately with `pip install duckdb`.
+**Optional dependencies:**
+- `duckdb` — required for `--where`, `--sort`, `--sql`, `--limit` with filtering
+  ```bash
+  pip install duckdb
+  ```
+- `pyarrow` — required for Parquet/GeoParquet files
+  ```bash
+  pip install pyarrow
+  ```
+- `h5py` — fallback for HDF5 files if GDAL lacks HDF5 support (usually not needed)
+  ```bash
+  pip install h5py
+  ```
+**Note on HDF support:**
+- **HDF5** (.h5, .hdf5): Supported via rasterio if GDAL has HDF5 support (most installations)
+- **HDF4** (.hdf): Requires GDAL compiled with HDF4 support (common in MODIS data)
+- **NetCDF** (.nc): Supported via rasterio (uses GDAL's NetCDF driver)
 ## Available options
 ```
@@ -120,37 +184,39 @@ General:
   --display DISPLAY     Resize only the displayed image (0.5=smaller, 2=bigger). Default: auto-fit to terminal.
 Raster:
-  --band BAND           Band number to display for single-band rasters. (default: 1)
-  --colormap            Apply colormap to single-band rasters. Flag without value → 'terrain'.
-  --rgb-bands RGB_BANDS Comma-separated band numbers for RGB display (e.g., '3,2,1'). Overrides default 1-3.
+  --band BAND           Band number to display (single raster), or slice number for NetCDF. (default: 1)
+  --timestep INTEGER    Alias for --band when working with NetCDF files.
+  --subset INTEGER      Variable index for NetCDF/HDF files (e.g., --subset 1).
+  --colormap            Apply colormap to single-band rasters. Flag without the color scheme → 'terrain'.
+  --rgb R G B           Three band numbers for RGB display (e.g., --rgb 4 3 2). Overrides default 1 2 3.
+  --rgbfiles R G B      Three single-band rasters for RGB composite. Can also provide as positional arguments.
   --vmin VMIN           Minimum pixel value for raster display scaling.
   --vmax VMAX           Maximum pixel value for raster display scaling.
-  --nodata NODATA       Override nodata value for rasters if dataset metadata is incorrect.
+  --nodata NODATA       Override nodata value for rasters if dataset metadata is missing or incorrect.
   --gallery [GRID]      Display all PNG/JPG/TIF images in a folder as thumbnails (e.g., 5x5 grid).
 Vector:
   --color-by COLUMN     Column to color vector features by.
   --colormap            Apply colormap to vector coloring. Flag without value → 'terrain'.
   --width WIDTH         Line width for vector boundaries. (default: 0.7)
-  --edgecolor COLOR     Edge color for vector outlines (hex or named color). (default: #F6FF00)
-  --layer LAYER         Layer name for GeoPackage or multi-layer files.
+  --edgecolor COLOR     Edge color for vector outlines (hex or named color). (default: white)
+  --layer LAYER         Layer name for GeoPackage/multi-layer files, or variable name for NetCDF files.
+  --table               Display vector/parquet file as tabular data instead of rendering geometry.
-CSV:
+CSV and Parquet:
   --describe [COLUMN]   Show summary statistics for all numeric columns or specify one column name.
   --hist [COLUMN]       Show histograms for all numeric columns or specify one column name.
   --bins BINS           Number of bins for histograms (used with --hist). (default: 20)
-  --scatter X Y         Plot scatter of two numeric CSV columns (e.g. --scatter area_km2 year).
+  --scatter X Y         Plot scatter of two numeric columns (e.g., --scatter area_km2 year).
   --unique COLUMN       Show unique values for a categorical column.
-  --where EXPR          Filter rows using SQL WHERE clause (DuckDB required) (e.g. --where "year > 2010")
-  --sort COLUMN         Sort rows by values in the specified column, ascending by default. Use --desc to reverse.
+  --where EXPR          Filter rows using SQL WHERE clause (DuckDB required). Example: --where "year > 2010"
+  --sort COLUMN         Sort rows by column, ascending by default. Use --desc to reverse.
   --desc                Sort in descending order (used with --sort).
-  --limit N             Limit number of rows shown (e.g. --limit 100).
-  --select COLUMNS      Select specific columns (space separated) (e.g. --select Country City).
-  --sql QUERY           Execute full DuckDB SQL query. Use 'data' as the table name (e.g. --sql "SELECT * FROM data WHERE Poverty > 40").
+  --limit N             Limit number of rows shown (e.g., --limit 100).
+  --select COLUMNS      Select specific columns (space separated). Example: --select Country City
+  --sql QUERY           Execute full DuckDB SQL query. Use 'data' as table name. Example: --sql "SELECT * FROM data WHERE Poverty > 40"
 ```
-</small>
 ## Need help?
 You can ask questions about usage via the documentation-based assistant:
@@ -159,7 +225,7 @@ You can ask questions about usage via the documentation-based assistant:
 👉 For NASA staff: find 'viewtif + viewgeom + viewinline Helper' via the ChatGSFC Agent Marketplace
 ## License
-This project is released under the Apache License 2.0 © 2025 Keiko Nomura.
+This project is released under the Apache License 2.0 © 2026 Keiko Nomura.
 If you find this tool useful, please consider supporting or acknowledging it in your work.

{viewinline-0.2.0 → viewinline-0.2.1}/README.md RENAMED Viewed

@@ -4,10 +4,12 @@
 [![Python version](https://img.shields.io/badge/python-%3E%3D3.9-blue.svg)](https://pypi.org/project/viewinline/)
 **Quick-look geospatial viewer for compatible terminals.**
-Displays rasters, vectors, and CSV data directly in the terminal with no GUI and no temporary files.
+Displays rasters, vectors, and tabular data directly in the terminal with no GUI and no temporary files.
 Think of it as `ls` for geospatial files — designed for quick visual inspection at the command line, not a replacement for QGIS, ArcGIS, or analytical workflows.
+Particularly useful on HPC systems and remote servers accessed via SSH. Images render on your local terminal without X11 forwarding, VNC, or file downloads.
 This tool combines the core display logic of `viewtif` and `viewgeom`, but is **non-interactive**: you can't zoom, pan, or switch colormaps on the fly. Instead, you control everything through command-line options (e.g. --display, --color-by, --colormap).
 It uses the iTerm2 inline image protocol (OSC 1337) to render previews. In incompatible terminals, the escape codes are silently ignored with no errors or crashes.
@@ -21,77 +23,130 @@ pip install viewinline
 ## Usage
 ```bash
+# Rasters
 viewinline path/to/file.tif
-viewinline path/to/vector.geojson
-viewinline R.tif G.tif B.tif                 # RGB composite
-viewinline path/to/multiband.tif --rgb-bands 3,2,1
+viewinline R.tif G.tif B.tif                 # RGB composite (also works with --rgbfiles)
+viewinline path/to/multiband.tif --rgb 3 2 1
 viewinline path/to/folder --gallery 4x3      # show image gallery (e.g. 4x3 grid)
+# NetCDF and HDF
+viewinline file.nc                           # list variables
+viewinline file.nc --subset 2                # display variable 2
+viewinline file.nc --subset 1 --band 10      # variable 1, timestep 10 --band or --timestep
+viewinline temp.nc --subset 1 --colormap plasma --vmin 273 --vmax 310
+# Vectors
+viewinline path/to/vector.geojson
+viewinline boundaries.geoparquet --color-by population --colormap viridis
+# CSV and Parquet
 viewinline data.csv                          # preview rows and columns
-viewinline data.csv --describe               # summary statistics for all numeric columns
-viewinline data.csv --describe Income        # summary statistics for one column
+viewinline data.parquet --describe           # summary statistics
 viewinline data.csv --hist                   # histograms for all numeric columns
 viewinline data.csv --hist area_km2          # histogram for one column
 viewinline data.csv --scatter X Y            # scatter plot
 viewinline data.csv --where "year > 2010"    # filter rows
-viewinline data.csv --sort population        # sort rows
+viewinline data.csv --sort population --desc # sort rows
 viewinline data.csv --sql "SELECT * FROM data WHERE area > 100 ORDER BY year"  # full SQL
+# Tabular view of vectors
+viewinline counties.shp --table              # view shapefile as table
+viewinline counties.shp --table --describe   # summary statistics
+viewinline counties.shp --table --unique STATE_NAME
+viewinline data.geoparquet --table --where "POP > 100000" --sort POP --desc
 ```
 ## Compatible terminals
-The iTerm2 inline image protocol is supported by:
+The iTerm2 inline image protocol (OSC 1337) is supported by:
 - **iTerm2** (macOS)
 - **WezTerm** (cross-platform)
 - **Konsole** (Linux/KDE)
-- **Rio**, **Contour** (Linux)
+- **Rio**, **Contour** (cross-platform)
+**Not compatible:** Mac Terminal, GNOME Terminal, Kitty (uses different protocol), Ghostty, Alacritty
-Not supported: Mac Terminal, GNOME Terminal, Kitty, Ghostty, Alacritty.
+**SSH/HPC usage:** Works over SSH when connecting from a compatible terminal. Images render on your local machine, not the remote server. No X11 forwarding or VNC required.
-> **Note:** Does not work inside tmux or screen.
+**tmux/screen:** Inline images don't work inside tmux or screen sessions, even with `allow-passthrough on`. Use a plain terminal tab.
 ## Features
-- Previews rasters, vectors and CSV files directly in the terminal
-- Non-interactive: everything is controlled through command-line options
+- Previews rasters, vectors, and tabular data directly in the terminal
+- Non-interactive: everything is controlled through command-line options
+- **NetCDF/HDF Support:** Display variables from NetCDF (.nc) and HDF5 (.h5, .hdf5) files with automatic nodata detection and multi-slice navigation
+- **Parquet/GeoParquet:** Render GeoParquet as vector maps or view as tabular data
+- **Tabular View for Vectors:** Use `--table` to access CSV-style operations (filter, sort, describe, hist) on any vector file
 ## Supported formats
 **Rasters**
 - GeoTIFF (.tif, .tiff)
 - PNG, JPEG (.png, .jpg, .jpeg)
+- NetCDF (.nc)
+- HDF5 (.h5, .hdf5)
+- HDF4 (.hdf) — requires GDAL with HDF4 support
 - Single-band or multi-band composites
 **Composite inputs**
-- You can pass three rasters (e.g. `R.tif G.tif B.tif`) to create an RGB composite
+- You can pass three rasters (e.g. `R.tif G.tif B.tif`) or use `--rgbfiles R.tif G.tif B.tif` to create an RGB composite
+- Multi-band files: use `--rgb 3 2 1` to specify band order
 **Vectors**
 - GeoJSON (`.geojson`)
-- Shapefile (`.shp`, `.dbf`, `.shx`)
-- GeoPackage (`.gpkg`)
-**CSV**
+- Shapefile (`.shp`)
+- GeoPackage (`.gpkg`)
+- Parquet/GeoParquet (`.parquet`, `.geoparquet`)
+**Tabular data (CSV and Parquet)**
+- CSV (`.csv`)
+- Parquet (`.parquet`) — requires `pyarrow`
+- All CSV operations work on parquet files
 - Preview file summary (rows, columns, and names)
 - Summary statistics with `--describe`
-- Show all numeric columns, or specify one (e.g. `--describe height`)
 - Inline histograms with `--hist`
-- Show all numeric columns, or specify one (e.g. `--hist area_km2`)
 - Scatter plots with `--scatter X Y`
 - Filter rows with `--where`, sort with `--sort`, limit output with `--limit`
-- Full SQL queries with `--sql` (DuckDB required) — use `data` as the table name (e.g. `--sql "SELECT State, AVG(Income) FROM data GROUP BY State"`)
+- Full SQL queries with `--sql` (DuckDB required) — use `data` as the table name
+**Tabular view of vectors**
+- Use `--table` flag to view any vector file (shapefiles, GeoPackage, GeoParquet) as tabular data
+- Enables all CSV-style operations: `--describe`, `--hist`, `--scatter`, `--unique`, `--where`, `--sort`
 **Gallery view**
 - Display all images in a folder with `--gallery 4x4`
+**NetCDF/HDF notes:**
+- viewinline lists only variables that can be displayed as 2D or 3D arrays
+- Variables with additional dimensions (e.g., vertical levels) may be listed but will fail to display with a clear error message
+- For a complete variable list, use `ncdump -h file.nc` or `viewtif`
 ## Dependencies
-Core dependencies (installed automatically):
-- `rasterio` — raster reading
+**Core dependencies** (installed automatically):
+- `rasterio` — raster reading (includes GDAL)
 - `geopandas`, `pyogrio` — vector reading
 - `matplotlib` — vector rendering
 - `Pillow` — image encoding
 - `numpy`, `pandas` — data handling
-Optional:
-- `duckdb` — required for `--where`, `--sort`, `--sql`, and `--limit` with filtering. Install separately with `pip install duckdb`.
+**Optional dependencies:**
+- `duckdb` — required for `--where`, `--sort`, `--sql`, `--limit` with filtering
+  ```bash
+  pip install duckdb
+  ```
+- `pyarrow` — required for Parquet/GeoParquet files
+  ```bash
+  pip install pyarrow
+  ```
+- `h5py` — fallback for HDF5 files if GDAL lacks HDF5 support (usually not needed)
+  ```bash
+  pip install h5py
+  ```
+**Note on HDF support:**
+- **HDF5** (.h5, .hdf5): Supported via rasterio if GDAL has HDF5 support (most installations)
+- **HDF4** (.hdf): Requires GDAL compiled with HDF4 support (common in MODIS data)
+- **NetCDF** (.nc): Supported via rasterio (uses GDAL's NetCDF driver)
 ## Available options
 ```
@@ -99,37 +154,39 @@ General:
   --display DISPLAY     Resize only the displayed image (0.5=smaller, 2=bigger). Default: auto-fit to terminal.
 Raster:
-  --band BAND           Band number to display for single-band rasters. (default: 1)
-  --colormap            Apply colormap to single-band rasters. Flag without value → 'terrain'.
-  --rgb-bands RGB_BANDS Comma-separated band numbers for RGB display (e.g., '3,2,1'). Overrides default 1-3.
+  --band BAND           Band number to display (single raster), or slice number for NetCDF. (default: 1)
+  --timestep INTEGER    Alias for --band when working with NetCDF files.
+  --subset INTEGER      Variable index for NetCDF/HDF files (e.g., --subset 1).
+  --colormap            Apply colormap to single-band rasters. Flag without the color scheme → 'terrain'.
+  --rgb R G B           Three band numbers for RGB display (e.g., --rgb 4 3 2). Overrides default 1 2 3.
+  --rgbfiles R G B      Three single-band rasters for RGB composite. Can also provide as positional arguments.
   --vmin VMIN           Minimum pixel value for raster display scaling.
   --vmax VMAX           Maximum pixel value for raster display scaling.
-  --nodata NODATA       Override nodata value for rasters if dataset metadata is incorrect.
+  --nodata NODATA       Override nodata value for rasters if dataset metadata is missing or incorrect.
   --gallery [GRID]      Display all PNG/JPG/TIF images in a folder as thumbnails (e.g., 5x5 grid).
 Vector:
   --color-by COLUMN     Column to color vector features by.
   --colormap            Apply colormap to vector coloring. Flag without value → 'terrain'.
   --width WIDTH         Line width for vector boundaries. (default: 0.7)
-  --edgecolor COLOR     Edge color for vector outlines (hex or named color). (default: #F6FF00)
-  --layer LAYER         Layer name for GeoPackage or multi-layer files.
+  --edgecolor COLOR     Edge color for vector outlines (hex or named color). (default: white)
+  --layer LAYER         Layer name for GeoPackage/multi-layer files, or variable name for NetCDF files.
+  --table               Display vector/parquet file as tabular data instead of rendering geometry.
-CSV:
+CSV and Parquet:
   --describe [COLUMN]   Show summary statistics for all numeric columns or specify one column name.
   --hist [COLUMN]       Show histograms for all numeric columns or specify one column name.
   --bins BINS           Number of bins for histograms (used with --hist). (default: 20)
-  --scatter X Y         Plot scatter of two numeric CSV columns (e.g. --scatter area_km2 year).
+  --scatter X Y         Plot scatter of two numeric columns (e.g., --scatter area_km2 year).
   --unique COLUMN       Show unique values for a categorical column.
-  --where EXPR          Filter rows using SQL WHERE clause (DuckDB required) (e.g. --where "year > 2010")
-  --sort COLUMN         Sort rows by values in the specified column, ascending by default. Use --desc to reverse.
+  --where EXPR          Filter rows using SQL WHERE clause (DuckDB required). Example: --where "year > 2010"
+  --sort COLUMN         Sort rows by column, ascending by default. Use --desc to reverse.
   --desc                Sort in descending order (used with --sort).
-  --limit N             Limit number of rows shown (e.g. --limit 100).
-  --select COLUMNS      Select specific columns (space separated) (e.g. --select Country City).
-  --sql QUERY           Execute full DuckDB SQL query. Use 'data' as the table name (e.g. --sql "SELECT * FROM data WHERE Poverty > 40").
+  --limit N             Limit number of rows shown (e.g., --limit 100).
+  --select COLUMNS      Select specific columns (space separated). Example: --select Country City
+  --sql QUERY           Execute full DuckDB SQL query. Use 'data' as table name. Example: --sql "SELECT * FROM data WHERE Poverty > 40"
 ```
-</small>
 ## Need help?
 You can ask questions about usage via the documentation-based assistant:
@@ -138,7 +195,7 @@ You can ask questions about usage via the documentation-based assistant:
 👉 For NASA staff: find 'viewtif + viewgeom + viewinline Helper' via the ChatGSFC Agent Marketplace
 ## License
-This project is released under the Apache License 2.0 © 2025 Keiko Nomura.
+This project is released under the Apache License 2.0 © 2026 Keiko Nomura.
 If you find this tool useful, please consider supporting or acknowledging it in your work.

{viewinline-0.2.0 → viewinline-0.2.1}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 [project]
 name = "viewinline"
-version = "0.2.0"
+version = "0.2.1"
 description = "Quick look geospatial viewer for iTerm2 compatible terminals"
 readme = "README.md"
 license = { text = "Apache-2.0" }
@@ -12,17 +12,22 @@ authors = [
   { name = "Keiko Nomura" }
 ]
 requires-python = ">=3.9"
 dependencies = [
   "numpy",
   "pillow",
   "rasterio",
   "geopandas",
   "matplotlib",
-  "pyogrio"
+  "pyogrio",
+  "pandas"
 ]
 [project.optional-dependencies]
 sql = ["duckdb"]
+parquet = ["pyarrow"]
+hdf5 = ["h5py"]
+all = ["duckdb", "pyarrow", "h5py"]
 [project.scripts]
 viewinline = "viewinline.viewinline:main"

{viewinline-0.2.0 → viewinline-0.2.1}/src/viewinline/viewinline.py RENAMED Viewed

@@ -3,14 +3,17 @@
 viewinline — quick-look geospatial viewer with inline image support.
 Supports:
-  • Rasters (.tif, .tiff, .png, .jpg, .jpeg)
-  • Vectors (.shp, .geojson, .gpkg)
+  • Rasters (.tif, .tiff, .png, .jpg, .jpeg, .nc, .hdf)
+  • Vectors (.shp, .geojson, .gpkg, .parquet, .geoparquet)
   • CSV (.csv) scatter plots and histograms
 Display:
   Sends iTerm2-style inline image escape sequences. Works in terminals that support
   the iTerm2 inline image protocol (iTerm2, WezTerm, Konsole, etc.). In other
-  terminals, the escape codes are harmlessly ignored.
+  terminals, the escape codes are ignored.
+  Particularly useful on HPC systems and remote servers accessed via SSH — images
+  render on your local terminal without X11 forwarding, VNC, or file downloads.
   No detection, no fallbacks. If images are not shown, it means that the terminal
   is not compatible.
@@ -29,7 +32,7 @@ import warnings
 warnings.filterwarnings("ignore", message="More than one layer found", category=UserWarning)
 warnings.filterwarnings("ignore", message="Dataset has no geotransform", category=UserWarning)
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 AVAILABLE_COLORMAPS = [
     "viridis", "inferno", "magma", "plasma",
@@ -40,7 +43,7 @@ AVAILABLE_COLORMAPS = [
 # ---------------------------------------------------------------------
 # Display utilities
 # ---------------------------------------------------------------------
-def show_inline_image(image_array: np.ndarray, display_scale: float | None = None, is_vector: bool = False) -> None:
+def show_inline_image(image_array: np.ndarray, display_scale = None, is_vector: bool = False) -> None:
     """Encode image and write iTerm2 inline escape sequence to stdout.
     Raises only if image encoding fails. Cannot detect whether the terminal
@@ -68,7 +71,7 @@ def show_inline_image(image_array: np.ndarray, display_scale: float | None = Non
     sys.stdout.flush()
-def show_image_auto(img: np.ndarray, display_scale: float | None = None, is_vector: bool = False) -> None:
+def show_image_auto(img: np.ndarray, display_scale = None, is_vector: bool = False) -> None:
     """Attempt inline image display. No fallbacks, no detection.
     Just sends the iTerm2 inline image escape sequence. If the terminal supports it,
@@ -179,7 +182,6 @@ def preview_df(df, max_rows: int = 10, query_mode: bool = False, filename: str =
 # Describe
 # =============================================================
 def describe_df(df, column=None):
     if df is None or df.empty:
         print("[WARN] No data rows found.")
         return
@@ -497,7 +499,6 @@ def render_simple_image(filepath: str, args) -> None:
     except Exception as e:
         print(f"[ERROR] Failed to load image: {e}")
 def render_raster(paths: list[str], args) -> None:
     try:
         import rasterio
@@ -507,14 +508,72 @@ def render_raster(paths: list[str], args) -> None:
         return
     try:
         if len(paths) == 1:
+            path = paths[0]
+            # Handle NetCDF/HDF with subdatasets
+            if path.lower().endswith(('.nc', '.hdf', '.hdf5', '.h5')):
+                try:
+                    with rasterio.open(path) as src:
+                        subdatasets = src.subdatasets
+                    # If there are subdatasets, require --subset to select one
+                    if subdatasets:
+                        if not args.subset:
+                            file_type = "variables" if path.lower().endswith('.nc') else "datasets"
+                            print(f"Found {len(subdatasets)} {file_type} in {os.path.basename(path)}:")
+                            for i, sub in enumerate(subdatasets, 1):
+                                # Extract dataset/variable name from GDAL subdataset string
+                                ds_name = sub.split(':')[-1].lstrip('/')
+                                print(f"  [{i}] {ds_name}")
+                            print(f"\nUse --subset <N> to display a specific {file_type[:-1]}.")
+                            return
+                        # Select by index
+                        if args.subset < 1 or args.subset > len(subdatasets):
+                            print(f"[ERROR] --subset must be between 1 and {len(subdatasets)}")
+                            return
+                        path = subdatasets[args.subset - 1]
+                        var_name = path.split(':')[-1]
+                        print(f"[INFO] Displaying variable {args.subset}: {var_name}")
+                except rasterio.errors.RasterioIOError as e:
+                    # GDAL lacks support, try h5py fallback for HDF5
+                    if path.lower().endswith(('.hdf5', '.h5')):
+                        try:
+                            import h5py
+                        except ImportError:
+                            print("[ERROR] HDF5 file cannot be opened.")
+                            print("[INFO] Requires either:")
+                            print("        - GDAL with HDF5 support, or")
+                            print("        - h5py: pip install h5py")
+                            return
+                        # print("[ERROR] h5py fallback not yet implemented.")
+                        print("[INFO] Install GDAL with HDF5")
+                        return
+                    elif path.lower().endswith('.hdf'):
+                        print(f"[ERROR] Cannot open HDF4 file: {e}")
+                        print("[INFO] HDF4 requires GDAL with HDF4 support")
+                        return
+                    else:
+                        # NetCDF error
+                        print(f"[ERROR] Cannot open NetCDF file: {e}")
+                        return
-            with rasterio.open(paths[0]) as ds:
+            # Continue with normal raster opening
+            with rasterio.open(path) as ds:
                 H, W = ds.height, ds.width
                 print(f"[DATA] Raster loaded: {os.path.basename(paths[0])} ({W}×{H})")
                 band_count = ds.count
+                # Auto-detect nodata from file metadata
+                if args.nodata is None and ds.nodata is not None:
+                    args.nodata = ds.nodata
                 # Downsample for performance
                 max_dim = 2000
@@ -532,19 +591,25 @@ def render_raster(paths: list[str], args) -> None:
                 else:
                     data = ds.read()
-            # MULTI BAND
-            if band_count >= 3:
+            # Print band/slice count for all multi-band files
+            if band_count > 1:
+                if paths[0].lower().endswith('.nc'):
+                    print(f"[INFO] {band_count} slices detected")
+                else:
+                    print(f"[INFO] Multi-band raster detected ({band_count} bands)")
+            # MULTI BAND RGB (skip for NetCDF - treat as slices/timesteps, not RGB)
+            if band_count >= 3 and not paths[0].lower().endswith('.nc'):
-                print(f"[INFO] Multi-band raster detected ({band_count} bands)")
-                if getattr(args, "rgb_bands", None):
+                if getattr(args, "rgb", None):
                     try:
-                        rgb_idx = [int(b) - 1 for b in args.rgb_bands.split(",")]
+                        rgb_idx = [b - 1 for b in args.rgb]
                         if len(rgb_idx) != 3:
                             raise ValueError
-                        print(f"[INFO] Using RGB bands: {args.rgb_bands}")
+                        print(f"[INFO] Using RGB bands: {args.rgb}")
                     except Exception:
-                        print("[WARN] Invalid --rgb-bands. Using default 1,2,3")
+                        print("[WARN] Invalid --rgb. Using default 1 2 3")
                         rgb_idx = [0, 1, 2]
                 else:
                     rgb_idx = [0, 1, 2]
@@ -565,6 +630,7 @@ def render_raster(paths: list[str], args) -> None:
             else:
                 band_idx = max(0, min(args.band - 1, band_count - 1))
+                # print(f"[INFO] Displaying band {band_idx + 1} of {band_count}")
                 raw_band = data[band_idx].astype(float)
                 # mask nodata
@@ -576,7 +642,14 @@ def render_raster(paths: list[str], args) -> None:
                 if np.any(np.isfinite(raw_band)):
                     min_val = np.nanmin(raw_band)
                     max_val = np.nanmax(raw_band)
-                    print(f"[DATA] Value range (preview): {min_val:.3f} → {max_val:.3f}")
+                    if paths[0].lower().endswith('.nc'):
+                        print(f"[DATA] Slice {band_idx + 1} of {band_count} — value range: {min_val:.3f} → {max_val:.3f}")
+                        if band_count > 1:
+                            print(f"[INFO] Use --band <N> to display a different slice")
+                    else:
+                        print(f"[DATA] Band {band_idx + 1} of {band_count} — value range: {min_val:.3f} → {max_val:.3f}")
                 else:
                     print("[WARN] No valid pixels found.")
@@ -629,7 +702,12 @@ def render_raster(paths: list[str], args) -> None:
         show_image_auto(img, getattr(args, "display", None), is_vector=False)
     except Exception as e:
-        print(f"[ERROR] Raster rendering failed: {e}")
+        if paths[0].lower().endswith('.nc'):
+            print(f"[ERROR] Cannot display this variable.")
+            print("[INFO] viewinline only supports 2D or 3D NetCDF variables")
+        else:
+            print(f"[ERROR] Raster rendering failed: {e}")
 def render_gallery(folder: str, grid: str = "4x4", display_scale=None, is_vector=False) -> None:
     """Render a folder of rasters/images as small thumbnails in a grid."""
@@ -733,37 +811,51 @@ def render_vector(path, args):
     except Exception as e:
         print(f"[WARN] Could not list layers: {e}")
+    # try:
+    #     gdf = gpd.read_file(path, layer=getattr(args, "layer", None))
+    #     print(f"[DATA] Vector loaded: {os.path.basename(path)} ({len(gdf)} features)")
+    # except Exception as e:
+    #     print(f"[ERROR] Failed to read vector: {e}")
+    #     return
     try:
-        gdf = gpd.read_file(path, layer=getattr(args, "layer", None))
+        # Use read_parquet for parquet/geoparquet files
+        if path.lower().endswith(('.parquet', '.geoparquet')):
+            gdf = gpd.read_parquet(path)
+        else:
+            gdf = gpd.read_file(path, layer=getattr(args, "layer", None))
         print(f"[DATA] Vector loaded: {os.path.basename(path)} ({len(gdf)} features)")
+    except ImportError:
+        print("[ERROR] Parquet/GeoParquet support requires pyarrow. Install with: pip install pyarrow")
+        return
     except Exception as e:
         print(f"[ERROR] Failed to read vector: {e}")
         return
     # Detect non-geometry columns
     all_cols = [c for c in gdf.columns if c != gdf.geometry.name]
     if all_cols:
         n = len(all_cols)
-        print(f"[INFO] Available columns ({n}):")
-        if n <= 20:
-            for c in all_cols:
-                print(f"  {c}")
-        else:
-            ncols = 2 if n <= 30 else 3 if n <= 100 else 4
-            nrows = (n + ncols - 1) // ncols
-            padded = all_cols + [""] * (nrows * ncols - n)
-            col_width = max(len(c) for c in all_cols) + 3
-            for i in range(nrows):
-                row = ""
-                for j in range(ncols):
-                    row += padded[i + j * nrows].ljust(col_width)
-                print("  " + row.rstrip())
-        if not args.color_by:
+        if not args.color_by:  # Only show columns if user didn't specify one
+            print(f"[INFO] Available columns ({n}):")
+            if n <= 20:
+                for c in all_cols:
+                    print(f"  {c}")
+            else:
+                ncols = 2 if n <= 30 else 3 if n <= 100 else 4
+                nrows = (n + ncols - 1) // ncols
+                padded = all_cols + [""] * (nrows * ncols - n)
+                col_width = max(len(c) for c in all_cols) + 3
+                for i in range(nrows):
+                    row = ""
+                    for j in range(ncols):
+                        row += padded[i + j * nrows].ljust(col_width)
+                    print("  " + row.rstrip())
             print("[INFO] Showing border-only view (use --color-by <column> to color features).")
     else:
         print("[INFO] No attribute columns found.")
     # Figure setup
     fig, ax = plt.subplots(figsize=(6, 6), dpi=150, facecolor="gray")
     ax.set_facecolor("gray")
@@ -808,8 +900,10 @@ def render_vector(path, args):
                         cmap=cmap,
                         vmin=vmin,
                         vmax=vmax,
-                        linewidth=0.2,
-                        edgecolor="white",
+                        linewidth=0,
+                        edgecolor="none",
+                        # linewidth=getattr(args, "width", 0.2),
+                        # edgecolor=args.edgecolor,
                         zorder=1
                     )
@@ -827,8 +921,10 @@ def render_vector(path, args):
                     subset.plot(
                         ax=ax,
                         facecolor=color,
-                        edgecolor="white",
-                        linewidth=0.2,
+                        linewidth=0,
+                        edgecolor="none",
+                        # edgecolor=args.edgecolor,
+                        # linewidth=getattr(args, "width", 0.2),
                         zorder=1
                     )
@@ -887,6 +983,157 @@ class SmartDefaults(argparse.ArgumentDefaultsHelpFormatter):
 # ---------------------------------------------------------------------
 # Dispatcher
 # ---------------------------------------------------------------------
+def handle_tabular_data(df: pd.DataFrame, args, filepath: str) -> None:
+    """Handle CSV/parquet/vector-as-table with all tabular operations."""
+    if args.sql and (args.where or args.sort or args.limit or args.select):
+        print("[ERROR] --sql cannot be combined with --where/--sort/--limit/--select.")
+        sys.exit(1)
+    if args.sql:
+        try:
+            import duckdb
+        except ImportError:
+            print("[ERROR] --sql requires DuckDB. Install with: pip install duckdb")
+            sys.exit(1)
+        print("[INFO] Executing SQL query...")
+        try:
+            query = args.sql.replace("data", f"read_csv_auto('{filepath}')")
+            con = duckdb.connect()
+            df = con.execute(query).df()
+            con.close()
+        except Exception as e:
+            print(f"[ERROR] DuckDB SQL failed: {e}")
+            sys.exit(1)
+        if df.empty:
+            print("[WARN] Query returned no rows.")
+            return
+        if args.describe:
+            if isinstance(args.describe, str):
+                describe_df(df, column=args.describe)
+            else:
+                describe_df(df)
+            return
+        if args.hist:
+            if isinstance(args.hist, str):
+                inline_histogram_df(df, column=args.hist, bins=args.bins,
+                                  display_scale=args.display, is_vector=False)
+            else:
+                inline_histogram_df(df, bins=args.bins,
+                                  display_scale=args.display, is_vector=False)
+            return
+        if args.scatter:
+            plot_scatter_df(df, args.scatter[0], args.scatter[1],
+                          display_scale=args.display, is_vector=False)
+            return
+        preview_df(df, max_rows=10, query_mode=True)
+        return
+    if args.where or args.sort or args.limit or args.select:
+        try:
+            import duckdb
+        except ImportError:
+            print("[ERROR] Filtering requires DuckDB. Install with: pip install duckdb")
+            sys.exit(1)
+        print("[INFO] Building query...")
+        base_query = "SELECT * FROM df"
+        if args.select:
+            selected = ", ".join(args.select)
+            print(f"[INFO] Selecting columns: {selected}")
+            base_query = f"SELECT {selected} FROM df"
+        clauses = []
+        if args.where:
+            print(f"[INFO] Applying filter: {args.where}")
+            clauses.append(f"WHERE {args.where}")
+        if args.sort:
+            direction = "DESC" if args.desc else "ASC"
+            print(f"[INFO] Sorting by: {args.sort} ({direction})")
+            clauses.append(f"ORDER BY {args.sort} {direction}")
+        if args.limit:
+            print(f"[INFO] Limiting rows: {args.limit}")
+            clauses.append(f"LIMIT {args.limit}")
+        query = " ".join([base_query] + clauses)
+        try:
+            df = duckdb.query(query).to_df()
+        except Exception as e:
+            print(f"[ERROR] DuckDB query failed: {e}")
+            sys.exit(1)
+        if df.empty:
+            print("[WARN] Query returned no rows.")
+            return
+    if args.unique:
+        col = args.unique
+        if col not in df.columns:
+            print(f"[ERROR] Column '{col}' not found.")
+            return
+        vals = sorted(df[col].dropna().astype(str).unique())
+        n = len(vals)
+        print(f"[DATA] Unique values in '{col}' ({n}):")
+        if n == 0:
+            print("  (none)")
+            return
+        if n <= 10:
+            for v in vals:
+                print(f"  {v}")
+        else:
+            ncols = 2 if n <= 30 else 3 if n <= 100 else 4
+            nrows = (n + ncols - 1) // ncols
+            vals += [""] * (nrows * ncols - n)
+            col_width = max(len(v) for v in vals) + 3
+            for i in range(nrows):
+                row = ""
+                for j in range(ncols):
+                    row += vals[i + j * nrows].ljust(col_width)
+                print("  " + row.rstrip())
+            return
+    if args.describe:
+        if isinstance(args.describe, str):
+            describe_df(df, column=args.describe)
+        else:
+            describe_df(df)
+        return
+    if args.hist:
+        if isinstance(args.hist, str):
+            inline_histogram_df(df, column=args.hist, bins=args.bins,
+                              display_scale=args.display, is_vector=False)
+        else:
+            inline_histogram_df(df, bins=args.bins,
+                              display_scale=args.display, is_vector=False)
+        return
+    if args.scatter:
+        plot_scatter_df(df, args.scatter[0], args.scatter[1],
+                      display_scale=args.display, is_vector=False)
+        return
+    preview_df(df, max_rows=args.limit or 10, query_mode=bool(args.where or args.sort or args.select))
 def main() -> None:
     parser = argparse.ArgumentParser(
         prog="viewinline",
@@ -901,10 +1148,9 @@ def main() -> None:
     # File input
     parser.add_argument(
-        "paths", nargs="+",
+        "paths", nargs="*",  # Zero or more (optional)
         help="Path to raster(s), vector, or CSV file. Provide 1 file or exactly 3 rasters for RGB (R G B)."
     )
     # Display options
     parser.add_argument(
         "--display", type=float, default=None,
@@ -914,7 +1160,11 @@ def main() -> None:
     # Raster options
     parser.add_argument(
         "--band", type=int, default=1,
-        help="Band number to display (single raster case)."
+        help="Band number to display (single raster case), or slice number for NetCDF."
+    )
+    parser.add_argument(
+        "--timestep", type=int, default=None,
+        help="Alias for --band when working with NetCDF files (1-based index)."
     )
     parser.add_argument(
         "--colormap", nargs="?", const="terrain",
@@ -922,8 +1172,8 @@ def main() -> None:
         help="Apply colormap to single-band rasters or vector coloring. Flag without value → 'terrain'."
     )
     parser.add_argument(
-        "--rgb-bands", type=str, default=None,
-        help="Comma-separated band numbers for RGB display (e.g., '3,2,1'). Overrides default 1-3."
+        "--rgb", nargs=3, type=int, metavar=('R', 'G', 'B'), default=None,
+        help="Three band numbers for RGB display (e.g., --rgb 4 3 2). Overrides default 1 2 3."
     )
     parser.add_argument(
         "--vmin", type=float, default=None,
@@ -935,12 +1185,20 @@ def main() -> None:
     )
     parser.add_argument(
         "--nodata", type=float, default=None,
-        help="Override nodata value for rasters if dataset metadata is incorrect."
+        help="Override nodata value for rasters if dataset metadata is missing or incorrect."
     )
     parser.add_argument(
     "--gallery", nargs="?", const="4x4", metavar="GRID",
     help="Display all PNG/JPG/TIF images in a folder as thumbnails (e.g., 5x5 grid)."
 )
+    parser.add_argument(
+        "--subset", type=int, default=None,
+        help="Variable index for NetCDF files (e.g. --subset 1)."
+    )
+    parser.add_argument(
+        "--rgbfiles", nargs=3, type=str, metavar=('R', 'G', 'B'),
+        help="Three single-band rasters for RGB composite (e.g., --rgbfiles R.tif G.tif B.tif). Can also provide as positional arguments without the flag."
+    )
     # CSV options
     parser.add_argument(
@@ -1017,13 +1275,30 @@ def main() -> None:
     )
     parser.add_argument(
         "--layer", type=str, default=None,
-        help="Layer name for GeoPackage or multi-layer files."
+        # help="Layer name for GeoPackage or multi-layer files."
+        help="Layer name for GeoPackage/multi-layer files, or variable name for NetCDF files."
     )
+    parser.add_argument(
+    "--table", action="store_true",
+    help="Display vector/parquet file as tabular data instead of rendering geometry."
+)
     parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
     args = parser.parse_args()
+    # Handle --rgbfiles flag (takes precedence)
+    if args.rgbfiles:
+        args.paths = args.rgbfiles
+    # Handle aliases
+    if args.timestep is not None:
+        args.band = args.timestep
+    # Validate input
+    if not args.paths:
+        parser.error("No input file(s) provided")
     # Basic argument sanity check
     for bad in ("color-by", "edgecolor", "colormap", "band", "display"):
         for a in args.paths:
@@ -1035,8 +1310,8 @@ def main() -> None:
     paths = args.paths
     # File routing
-    raster_exts = (".png", ".jpg", ".jpeg", ".tif", ".tiff")
-    vector_exts = (".shp", ".geojson", ".json", ".gpkg")
+    raster_exts = (".png", ".jpg", ".jpeg", ".tif", ".tiff", ".nc", ".hdf", ".hdf5", ".h5")
+    vector_exts = (".shp", ".geojson", ".json", ".gpkg", ".parquet", "geoparquet")
     if len(paths) == 1:
         p = paths[0].lower()
@@ -1054,173 +1329,54 @@ def main() -> None:
             return
         elif p.endswith(vector_exts):
-            render_vector(paths[0], args)
-            return
-        if os.path.isdir(paths[0]) and args.gallery:
-            render_gallery(paths[0], grid=args.gallery, display_scale=args.display, is_vector=False)
-            return
-        elif p.endswith(".csv"):
-            # CSV handling (unchanged from original)
-            if args.sql and (args.where or args.sort or args.limit or args.select):
-                print("[ERROR] --sql cannot be combined with --where/--sort/--limit/--select.")
-                sys.exit(1)
-            try:
-                df = pd.read_csv(paths[0])
-            except Exception as e:
-                print(f"[ERROR] Failed to read CSV: {e}")
-                sys.exit(1)
-            if args.sql:
-                try:
-                    import duckdb
-                except ImportError:
-                    print("[ERROR] --sql requires DuckDB. Install with: pip install duckdb")
-                    sys.exit(1)
-                print("[INFO] Executing SQL query...")
+            if args.table:
+                # Treat as tabular data
                 try:
-                    query = args.sql.replace("data", f"read_csv_auto('{paths[0]}')")
-                    con = duckdb.connect()
-                    df = con.execute(query).df()
-                    con.close()
-                except Exception as e:
-                    print(f"[ERROR] DuckDB SQL failed: {e}")
-                    sys.exit(1)
-                if df.empty:
-                    print("[WARN] Query returned no rows.")
-                    return
-                if args.describe:
-                    if isinstance(args.describe, str):
-                        describe_df(df, column=args.describe)
-                    else:
-                        describe_df(df)
-                    return
-                if args.hist:
-                    if isinstance(args.hist, str):
-                        inline_histogram_df(df, column=args.hist, bins=args.bins,
-                                          display_scale=args.display, is_vector=False)
+                    if p.endswith(('.parquet', '.geoparquet')):
+                        df = pd.read_parquet(paths[0])
                     else:
-                        inline_histogram_df(df, bins=args.bins,
-                                          display_scale=args.display, is_vector=False)
-                    return
-                if args.scatter:
-                    plot_scatter_df(df, args.scatter[0], args.scatter[1],
-                                  display_scale=args.display, is_vector=False)
+                        import geopandas as gpd
+                        gdf = gpd.read_file(paths[0])
+                        df = pd.DataFrame(gdf.drop(columns='geometry'))
+                    handle_tabular_data(df, args, paths[0])
                     return
-                preview_df(df, max_rows=10, query_mode=True)
-                return
-            if args.where or args.sort or args.limit or args.select:
-                try:
-                    import duckdb
-                except ImportError:
-                    print("[ERROR] Filtering requires DuckDB. Install with: pip install duckdb")
-                    sys.exit(1)
-                print("[INFO] Building query...")
-                base_query = "SELECT * FROM df"
-                if args.select:
-                    selected = ", ".join(args.select)
-                    print(f"[INFO] Selecting columns: {selected}")
-                    base_query = f"SELECT {selected} FROM df"
-                clauses = []
-                if args.where:
-                    print(f"[INFO] Applying filter: {args.where}")
-                    clauses.append(f"WHERE {args.where}")
-                if args.sort:
-                    direction = "DESC" if args.desc else "ASC"
-                    print(f"[INFO] Sorting by: {args.sort} ({direction})")
-                    clauses.append(f"ORDER BY {args.sort} {direction}")
-                if args.limit:
-                    print(f"[INFO] Limiting rows: {args.limit}")
-                    clauses.append(f"LIMIT {args.limit}")
-                query = " ".join([base_query] + clauses)
-                try:
-                    df = duckdb.query(query).to_df()
                 except Exception as e:
-                    print(f"[ERROR] DuckDB query failed: {e}")
+                    print(f"[ERROR] Failed to read file: {e}")
                     sys.exit(1)
-                if df.empty:
-                    print("[WARN] Query returned no rows.")
-                    return
-            if args.unique:
-                col = args.unique
-                if col not in df.columns:
-                    print(f"[ERROR] Column '{col}' not found.")
-                    return
-                vals = sorted(df[col].dropna().astype(str).unique())
-                n = len(vals)
-                print(f"[DATA] Unique values in '{col}' ({n}):")
-                if n == 0:
-                    print("  (none)")
-                    return
-                if n <= 10:
-                    ncols = 1
-                elif n <= 30:
-                    ncols = 2
-                elif n <= 100:
-                    ncols = 3
-                else:
-                    ncols = 4
-                nrows = (n + ncols - 1) // ncols
-                vals += [""] * (nrows * ncols - n)
-                col_width = max(len(v) for v in vals) + 3
-                for i in range(nrows):
-                    row = ""
-                    for j in range(ncols):
-                        row += vals[i + j * nrows].ljust(col_width)
-                    print("  " + row.rstrip())
+            else:
+                render_vector(paths[0], args)
                 return
-            if args.describe:
-                if isinstance(args.describe, str):
-                    describe_df(df, column=args.describe)
-                else:
-                    describe_df(df)
-                return
+        if os.path.isdir(paths[0]) and args.gallery:
+            render_gallery(paths[0], grid=args.gallery, display_scale=args.display, is_vector=False)
+            return
-            if args.hist:
-                if isinstance(args.hist, str):
-                    inline_histogram_df(df, column=args.hist, bins=args.bins,
-                                      display_scale=args.display, is_vector=False)
+        elif p.endswith((".csv", ".parquet")):
+            # Try geoparquet first if it's a parquet file
+            if p.endswith(".parquet"):
+                try:
+                    import geopandas as gpd
+                    gdf = gpd.read_parquet(paths[0])
+                    if hasattr(gdf, 'geometry') and gdf.geometry is not None:
+                        render_vector(paths[0], args)
+                        return
+                except Exception:
+                    pass
+            # Read as tabular data
+            try:
+                if p.endswith(".parquet"):
+                    df = pd.read_parquet(paths[0])
                 else:
-                    inline_histogram_df(df, bins=args.bins,
-                                      display_scale=args.display, is_vector=False)
-                return
-            if args.scatter:
-                plot_scatter_df(df, args.scatter[0], args.scatter[1],
-                              display_scale=args.display, is_vector=False)
-                return
-            preview_df(df, max_rows=args.limit or 10, query_mode=bool(args.where or args.sort or args.select))
+                    df = pd.read_csv(paths[0])
+            except ImportError:
+                print("[ERROR] Parquet support requires pyarrow. Install with: pip install pyarrow")
+                sys.exit(1)
+            except Exception as e:
+                print(f"[ERROR] Failed to read file: {e}")
+                sys.exit(1)
+            handle_tabular_data(df, args, paths[0])
             return
         else:

{viewinline-0.2.0 → viewinline-0.2.1}/.github/FUNDING.yml RENAMED Viewed

File without changes

{viewinline-0.2.0 → viewinline-0.2.1}/.gitignore RENAMED Viewed

File without changes

{viewinline-0.2.0 → viewinline-0.2.1}/src/viewinline/__init__.py RENAMED Viewed

File without changes

viewinline 0.2.0__tar.gz → 0.2.1__tar.gz

viewinline 0.2.0tar.gz → 0.2.1tar.gz