httk.store.store_timestamp

Backend-neutral store-managed timestamp helpers.

Attributes

FUTURE_TIMESTAMP_SLACK_NS

Exceptions

StoreClockRegressionError

A writable store clock is behind its process-local timestamp mark.

Functions

capture_store_timestamp(clock, resolution, mark, *[, ...])	Capture one guarded store-unit timestamp from a nanosecond clock.
advance_store_timestamp_mark(mark, captured, *, ...)	Advance a process-local timestamp high-water mark after a successful save.
encode_store_timestamp_state(enabled, resolution)	Encode the persisted timestamp configuration marker.
parse_store_timestamp_state(value)	Parse a persisted timestamp marker, returning None for unknown values.
ns_operand_to_store_units(value, resolution)	Convert a nanosecond, aware datetime, or RFC3339 string to store units.

Module Contents

httk.store.store_timestamp.FUTURE_TIMESTAMP_SLACK_NS = 2000000000

exception httk.store.store_timestamp.StoreClockRegressionError(mark_ns, clock_ns)

Bases: RuntimeError

A writable store clock is behind its process-local timestamp mark.

httk.store.store_timestamp.capture_store_timestamp(clock, resolution, mark, *, allow_clock_regression=False, clock_regression_grace=True)

Capture one guarded store-unit timestamp from a nanosecond clock.

httk.store.store_timestamp.advance_store_timestamp_mark(mark, captured, *, allow_clock_regression)

Advance a process-local timestamp high-water mark after a successful save.

httk.store.store_timestamp.encode_store_timestamp_state(enabled, resolution)

Encode the persisted timestamp configuration marker.

httk.store.store_timestamp.parse_store_timestamp_state(value)

Parse a persisted timestamp marker, returning None for unknown values.

httk.store.store_timestamp.ns_operand_to_store_units(value, resolution)

Convert a nanosecond, aware datetime, or RFC3339 string to store units.