uber / h3-go / 27644218329

100%

push

github

feat: add pure-Go index introspection & hierarchy to x/h3go (#124)

Extend the cgo-free x/h3go reimplementation to cover the index
introspection and hierarchy API, all operating on the H3 index bit
layout with no geometric projection:

- introspection: BaseCellNumber, IsValid, IsPentagon, IsResClassIII,
  IndexDigit, NumCells
- hierarchy: Parent/ImmediateParent, Children/ImmediateChildren/
  CenterChild, CellToChildPos/ChildPosToCell, CompactCells/UncompactCells
- sets: Res0Cells, Pentagons
- conversions: IndexFromString/IndexToString, CellFromString/CellToString,
  MarshalText/UnmarshalText

Source is split by concern (index.go, hierarchy.go, sets.go, convert.go,
latlng.go, faceijk.go) over the shared core in h3go.go. childCells is a
native iter.Seq iterator. Add NumBaseCells/NumPentagons to internal/h3core.

Tests: in-package tests are white-box (package h3go) and self-sufficient,
co-located per source file, table-driven where applicable, with 100%
per-package statement coverage. Cross-implementation parity tests against
the cgo reference live in x/h3go/paritytest.

827 of 827 new or added lines in 6 files covered. (100.0%)

1704 of 1704 relevant lines covered (100.0%)

522659.04 hits per line