Utility functions around state changes.

Latest release 20240622: Changes to accomodate dropping BaseCommandOptions.runstate.

Function delta(old, new, keys=None)

Return a mapping representing differences between the mappings old and new for the specified keys. If keys is not specified, the union of the keys of old and new is used.

The returned mapping has a key for each changed value. If the key does not exist in new the value is the MISSING sentinel object otherwise it is new[key]. Values are compared using ==; if that raises TypeError the values are considered not equal.

Example:

d1 = {1: 2, 3: 4, 5: 6} d2 = {1: 2, 3: 44, 7: 8} diff = delta(d1, d2) diff # doctest: +ELLIPSIS {3: 44, 5: <object object at ...>, 7: 8} diff[5] is MISSING True

Function monitor(get_state, keys=None, *, ifunchanged=False, interval=0.3, runstate: Optional[cs.resources.RunState] = <function uses_runstate.<locals>.<lambda> at 0x1072e81f0>)

A generator yielding 3-tuples of (old,new,delta(old,new,keys)) at poll intervals of interval seconds.

Parameters:

• get_state: a callable which polls the current state, returning a mapping
• keys: an optional iterable of keys of interest; if omitted, all the old and new mapping keys are examined
• ifunchanged: optional flag, default False; if true yield a tuple on every poll instead of only when a state change is seen
• interval: an optional interpoll time.sleep period, default 0.3s
• runstate: an optional RunState, whose cancelled attribute will be polled for loop termination

Release Log

Release 20240622: Changes to accomodate dropping BaseCommandOptions.runstate.

Release 20240316: Fixed release upload artifacts.

Release 20240214: Initial PyPI release.