[client] Deduplicate aggregation docstrings: shared time-window parameter block (~250 lines repeated) #184
Loading…
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
_aggregations.pyrepeats the same parameter documentation —measure_kind,aggregation_level,aggregation_type,time_ago_unit,time_ago_value,start,end, with their live-pinned enums — nearly verbatim across the 6 public methods (~250 of the file's 381 lines). Every enum re-pin (e.g. commits12ccf49,5c33dcf) has to touch all copies, which is exactly how docstring drift starts.Fix options:
get_device_ts_time_ago) and have the others reference it ("Seeget_device_ts_time_agofor the shared time-window parameters"), documenting only what differs; orEither keeps
help()useful while leaving a single place to update when an enum is re-pinned live.Done when: the shared block exists in exactly one place;
pytest -qgreen; no public signature change.