Skip to main content

Utility functions around state changes.

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cs.delta-20240622.tar.gz (3.4 kB view hashes)

Uploaded Source

Built Distribution

cs.delta-20240622-py3-none-any.whl (3.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page