heat.common.timeutils module

Utilities for handling ISO 8601 duration format.

class heat.common.timeutils.Duration(timeout=0)[source]

Bases: object

endtime()[source]
expired()[source]
heat.common.timeutils.isotime(at)[source]

Stringify UTC time in ISO 8601 format.

Parameters:

at – Timestamp in UTC to format.

heat.common.timeutils.parse_isoduration(duration)[source]

Convert duration in ISO 8601 format to second(s).

Year, Month, Week, and Day designators are not supported. Example: ‘PT12H30M5S’

heat.common.timeutils.retry_backoff_delay(attempt, scale_factor=1.0, jitter_max=0.0)[source]

Calculate an exponential backoff delay with jitter.

Delay is calculated as 2^attempt + (uniform random from [0,1) * jitter_max)

Parameters:

  • attempt – The count of the current retry attempt

  • scale_factor – Multiplier to scale the exponential delay by

  • jitter_max – Maximum of random seconds to add to the delay

Returns:

Seconds since epoch to wait until