Simplify text diff and hierarchy reports
Use signed cell rows and keep whole-cell contents out of the text diff. Group reference changes, fold redundant terminal edges into the cell list, and inline one-off layer names. Count identical unmatched objects while retaining occurrence-based display limits.
This commit is contained in:
parent
9d5fe27516
commit
ed1e0595bc
1 changed files with 775 additions and 226 deletions
38
docs/cli.md
38
docs/cli.md
|
|
@ -46,13 +46,23 @@ pheon diff before.gds after.gds --hierarchy ascii --max-changes 20
|
|||
pheon diff before.gds after.gds --format json > report.json
|
||||
```
|
||||
|
||||
Text reports start with the result and counts of modified, added, and removed
|
||||
cells. Added and removed cells show their object counts and group references by
|
||||
target. Modified cells show counts of rectangles, polygons, and boxes changed,
|
||||
moved, added, or removed on each layer. Repeated reference additions or removals
|
||||
to the same target also appear as a count. Object details use `-` for removals,
|
||||
`+` for additions, and `~` for likely replacements. Unmatched paths with five
|
||||
or more vertices show their width, vertex count, and vertex bounds in one line.
|
||||
Text reports start with the result. The headline includes cell counts for
|
||||
reports with more than three changed cells, incomplete comparisons, or omitted
|
||||
changes. The `Cells:` section lists removals with `-`, additions with `+`, and
|
||||
modifications with `*`. Modified cells show counts of rectangles, polygons, and
|
||||
boxes changed, moved, added, or removed on each layer. Repeated reference
|
||||
additions or removals to the same target appear as a count. When both occur for
|
||||
one target, they share a row. A complete set of edits to a target also shows
|
||||
the total direct placements when there are unchanged placements, for example
|
||||
`leaf · -3 refs, +6 refs · placements 10 -> 13`.
|
||||
|
||||
An unchanged layer name appears inline when the layer occurs on one displayed
|
||||
row, as in `1/0 (WG): 1 rectangle moved`. A layer on several displayed rows
|
||||
gets one legend entry. Object details use `-` for removals, `+` for additions,
|
||||
and `~` for likely replacements. Identical unmatched objects share a row
|
||||
with a count such as `+ 12× 1/0: path …`. Unmatched paths with five or more
|
||||
vertices show their width, vertex count, and vertex bounds in one line.
|
||||
|
||||
Use `--format json` for details of individual objects and `--hierarchy` to see
|
||||
which parent cells are affected.
|
||||
|
||||
|
|
@ -101,17 +111,21 @@ pheon diff before.gds after.gds --hierarchy mermaid --depth 4
|
|||
comparison, totals, or exit status. A layer display filter hides references
|
||||
without a numeric layer. `--max-changes N` limits displayed object occurrences
|
||||
after filtering. Text defaults to 100 occurrences and shows a replacement only
|
||||
when both objects fit within the limit. A single omission line lists changes
|
||||
hidden by filters or the limit. JSON has no default object limit and reports
|
||||
when both objects fit within the limit. Grouped rows count each object toward
|
||||
the limit. A single omission line lists changes hidden by filters or the
|
||||
limit. JSON has no default object limit and reports
|
||||
omissions from both display filters and any explicit limit in `report_selection`.
|
||||
See the [JSON reference](diff-reports.md) for the selection counters.
|
||||
|
||||
The diff hierarchy shows directly changed cells, affected ancestors, and targets
|
||||
of modified references. It includes references from both revisions so removed
|
||||
branches remain visible. Counts represent direct placements, with symbolic
|
||||
counts for arrays. ASCII omits the section when there are no cell changes and
|
||||
marks reference changes whose placement count stays the same. Use `--depth`
|
||||
with text output.
|
||||
counts for arrays. ASCII uses the cell list's change markers and marks
|
||||
reference changes whose placement count stays the same. When the cell list
|
||||
shows all edits to an unchanged target on a single branch, ASCII can omit
|
||||
that terminal edge. The hierarchy retains ancestor paths, shared branches,
|
||||
and edges with edits hidden by display filters or limits. ASCII appears when
|
||||
there are relationships to show. Use `--depth` with text output.
|
||||
For the complete graph within the comparison scope, use
|
||||
`--format json --hierarchy graph` without `--depth`. Display filters leave the
|
||||
graph intact.
|
||||
|
|
|
|||
Loading…
Reference in a new issue