bluesky / hklpy2 / 24361263520

100%

push

github

feat: add GeometryDescriptor and SolverBase geometry registry (Phase 1) (#298)

* feat #293 add GeometryDescriptor dataclass to backends/typing

Introduces GeometryDescriptor, a dataclass that captures the static
facts about a diffractometer geometry (name, pseudo/real axis names,
modes, default mode, per-mode extra axis names, description) independent
of any solver backend library.

Exports GeometryDescriptor from hklpy2.backends.__init__ alongside
the existing SolverBase, ReflectionDict, SampleDict, and
SolverMetadataDict.

Agent: OpenCode (claudesonnet46)

* feat #292 add geometry registry and register_geometry() to SolverBase

Add SolverBase._geometry_registry (per-class dict) and
SolverBase.register_geometry() classmethod so solver subclasses can
register GeometryDescriptor objects at runtime, enabling dynamic and
ad-hoc diffractometer geometry definitions.

Refactor ThTthSolver to drive all property dispatch (pseudo_axis_names,
real_axis_names, modes, extra_axis_names, geometries()) from the
registry rather than hard-coded string conditionals.  The built-in
TH TTH Q geometry is registered at module import time via a module-level
GeometryDescriptor.

Add test_geometry_descriptor.py with parametrized tests covering
GeometryDescriptor construction, field independence, register_geometry()
validation, geometries() ordering, overwrite semantics, registry
isolation between SolverBase and ThTthSolver, property dispatch, and
dynamic runtime registration.

Agent: OpenCode (claudesonnet46)

* ci: enforce 100% code coverage via fail_under and CI report

Add [tool.coverage.report] to pyproject.toml with fail_under=100 and
exclude_also patterns for abstract-method stubs, TYPE_CHECKING guards,
and ellipsis-only lines that are genuinely untestable.

Remove the '|| true' suppressor from the 'coverage report' step in
code.yml so that a coverage shortfall now fails the CI build rather
than being silently swallowed.

Agent: OpenCode (claudesonnet46)

* ci: omit tes... (continued)

53 of 53 new or added lines in 4 files covered. (100.0%)

3034 of 3034 relevant lines covered (100.0%)

4.0 hits per line