a Nb @sJddlZddlZddlmZeeZGdddeZGdddeZ dS)N)MaximumRetriesExceededc@s*eZdZdZddfddZd ddZdS) Sleepersa A class that allows for the creation of multiple `Sleeper` objects with shared arguments. Examples: Firstly a `Sleepers` object containing the shared attributes has to be created. >>> max_retries, retry_timeout = 5, 5 >>> sleepers = Sleepers(max_retries, retry_timeout) From this `Sleepers` object multiple individual `Sleeper` objects can be created using the `make` method. >>> sleeper = sleepers.make() Args: max_retries (int): The maximum number of retries to perform. retry_timeout (int): The time to sleep for each past retry. callback (Callable[[int, Any], None]): A callable to be called on each retry. Attributes: max_retries (int): The maximum number of retries to perform. retry_timeout (int): The time to sleep for each past retry. callback (callable): A callable to be called on each retry. cGsdSN)xrrK/var/www/html/diaryflask/venv/lib/python3.9/site-packages/mwclient/sleep.pyzSleepers.cCs||_||_||_dSr) max_retries retry_timeoutcallback)selfr r r rrr__init__szSleepers.__init__NcCst||j|j|jS)z Creates a new `Sleeper` object. Args: args (Any): Arguments to be passed to the `callback` callable. Returns: Sleeper: A `Sleeper` object. )Sleeperr r r )r argsrrrmake!sz Sleepers.make)N)__name__ __module__ __qualname____doc__rrrrrrrsrc@s"eZdZdZddZdddZdS) ra For any given operation, a `Sleeper` object keeps count of the number of retries. For each retry, the sleep time increases until the max number of retries is reached and a `MaximumRetriesExceeded` is raised. The sleeper object should be discarded once the operation is successful. Args: args (Any): Arguments to be passed to the `callback` callable. max_retries (int): The maximum number of retries to perform. retry_timeout (int): The time to sleep for each past retry. callback (callable, None]): A callable to be called on each retry. Attributes: args (Any): Arguments to be passed to the `callback` callable. retries (int): The number of retries that have been performed. max_retries (int): The maximum number of retries to perform. retry_timeout (int): The time to sleep for each past retry. callback (callable): A callable to be called on each retry. cCs"||_d|_||_||_||_dS)Nr)rretriesr r r )r rr r r rrrr>s zSleeper.__init__rcCsn|jd7_|j|jkr&t||j|||j|j|j|jd}||krT|}td|t |dS)a/ Sleeps for a minimum of `min_time` seconds. The actual sleeping time will increase with the number of retries. Args: min_time (int): The minimum sleeping time. Raises: MaximumRetriesExceeded: If the number of retries exceeds the maximum. zSleeping for %d secondsN) rr rrr r logdebugtimesleep)r Zmin_timetimeoutrrrrEs    z Sleeper.sleepN)r)rrrrrrrrrrr,sr) rloggingZmwclient.errorsr getLoggerrrobjectrrrrrrs   $