openvax / topiary / 24309473407

84%

master: 90%

push

github

Add TopiaryResult wrapper and concat() for provenance tracking

Part of #109. TopiaryResult bundles a DataFrame with its Metadata so
that provenance (source files, model versions, form) travels with the
data and survives serialization round-trips.

New:
- topiary/result.py: TopiaryResult class + concat() function
- Delegates common DataFrame operations (__len__, __iter__, __getitem__,
  __contains__, columns, shape, empty, head, tail, iterrows, itertuples)
- Convenience properties: models, form, sources
- Methods: to_wide(), to_long(), to_tsv(), to_csv()
- concat(results) merges DataFrames + unions metadata, warns on model
  version conflicts, raises on mixed forms

Metadata:
- New sources: list[str] field; multiple #source= lines in comment block
- Parsed and written automatically

IO changes:
- read_tsv / read_csv now return TopiaryResult (breaking change)
- Accept optional tag= to label source; defaults to filename
- Add a 'source' column to the DataFrame on load (unless already present)
- to_tsv / to_csv accept either TopiaryResult or bare DataFrame

Bump to 4.12.0 (breaking API change).

Deferred to follow-up PRs (see #109):
- filter_by / sort_by methods (need top() DSL filter first)
- Predictor returns TopiaryResult by default

113 of 125 new or added lines in 3 files covered. (90.4%)

2421 of 2767 relevant lines covered (87.5%)

2.62 hits per line