Read gzip-compressed GDSII directly in the CLI

Detect gzip headers on every CLI input and decode all members before parsing.
Keep report offsets relative to the decompressed stream and report corrupt
archives as invalid input. Recognize OASIS headers and explain how to provide
GDSII data.

Cover mixed compressed and plain comparisons, corrupt trailers, and layer-name
output from compressed input.
This commit is contained in:
Jan Petykiewicz 2026-11-17 16:14:53 -08:00
commit 6e4b371046
3 changed files with 185 additions and 9 deletions

View file

@ -1,7 +1,8 @@
# Command-line tools
Use `pheon` to inspect a GDSII file, compare revisions, or trace cell references.
Use uncompressed `.gds` files with the CLI. It runs independently of Python.
The CLI recognizes gzip-compressed GDSII by its file header. Reported byte offsets
refer to the decompressed layout. The CLI runs independently of Python.
## Install

View file

@ -86,7 +86,8 @@ hex preserves their bytes.
Evidence follows the comparison profile: boundary/box rings are canonicalized,
string padding is removed, and fields/properties are sorted. REAL8 encodings and
explicit defaults remain significant. Source offsets locate original records.
explicit defaults remain significant. For gzip inputs, source offsets locate
records in the decompressed layout.
Replacements link report-local removed/added IDs with `match_rule`,
`field_changes`, and `properties_changed`. Rules are `unique_kind_layer_bounds`,

View file

@ -16,6 +16,8 @@ cell as the carrier. The carrier must contain no ordinary design objects.
The output path must be new; Pheon refuses to overwrite any existing file,
including the input.
The output is uncompressed GDSII, including when the input is gzip-compressed.
The command consolidates the legend into that cell. Existing mappings remain
unless you override them with `--name`. It creates no cells or references, and
copies other records, timestamps, unknown records, and trailing padding byte for