Expiration

Utility functions for parsing and converting expiration values

requests_cache.policy.expiration.get_expiration_datetime(expire_after, start_time=None, negative_delta=False, ignore_invalid_httpdate=False)

Convert an expiration value in any supported format to an absolute datetime

Parameters:

• expire_after (Union[None, int, float, str, datetime, timedelta]) –

• start_time (Optional[datetime]) –

• negative_delta (bool) –

• ignore_invalid_httpdate (bool) –

Return type:

Optional[datetime]

requests_cache.policy.expiration.get_expiration_seconds(expire_after)

Convert an expiration value in any supported format to an expiration time in seconds

Parameters:

expire_after (Union[None, int, float, str, datetime, timedelta]) –

Return type:

int

requests_cache.policy.expiration.get_url_expiration(url, urls_expire_after=None)

Check for a matching per-URL expiration, if any

Parameters:

• url (Optional[str]) –

• urls_expire_after (Optional[Dict[Union[str, Pattern], Union[None, int, float, str, datetime, timedelta]]]) –

Return type:

Union[None, int, float, str, datetime, timedelta]