123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596 |
- # Copyright 2016–2021 Julien Danjou
- # Copyright 2016 Joshua Harlow
- # Copyright 2013-2014 Ray Holder
- #
- # Licensed under the Apache License, Version 2.0 (the "License");
- # you may not use this file except in compliance with the License.
- # You may obtain a copy of the License at
- #
- # http://www.apache.org/licenses/LICENSE-2.0
- #
- # Unless required by applicable law or agreed to in writing, software
- # distributed under the License is distributed on an "AS IS" BASIS,
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- # See the License for the specific language governing permissions and
- # limitations under the License.
- import abc
- import typing
- if typing.TYPE_CHECKING:
- import threading
- from pip._vendor.tenacity import RetryCallState
- class stop_base(abc.ABC):
- """Abstract base class for stop strategies."""
- @abc.abstractmethod
- def __call__(self, retry_state: "RetryCallState") -> bool:
- pass
- def __and__(self, other: "stop_base") -> "stop_all":
- return stop_all(self, other)
- def __or__(self, other: "stop_base") -> "stop_any":
- return stop_any(self, other)
- class stop_any(stop_base):
- """Stop if any of the stop condition is valid."""
- def __init__(self, *stops: stop_base) -> None:
- self.stops = stops
- def __call__(self, retry_state: "RetryCallState") -> bool:
- return any(x(retry_state) for x in self.stops)
- class stop_all(stop_base):
- """Stop if all the stop conditions are valid."""
- def __init__(self, *stops: stop_base) -> None:
- self.stops = stops
- def __call__(self, retry_state: "RetryCallState") -> bool:
- return all(x(retry_state) for x in self.stops)
- class _stop_never(stop_base):
- """Never stop."""
- def __call__(self, retry_state: "RetryCallState") -> bool:
- return False
- stop_never = _stop_never()
- class stop_when_event_set(stop_base):
- """Stop when the given event is set."""
- def __init__(self, event: "threading.Event") -> None:
- self.event = event
- def __call__(self, retry_state: "RetryCallState") -> bool:
- return self.event.is_set()
- class stop_after_attempt(stop_base):
- """Stop when the previous attempt >= max_attempt."""
- def __init__(self, max_attempt_number: int) -> None:
- self.max_attempt_number = max_attempt_number
- def __call__(self, retry_state: "RetryCallState") -> bool:
- return retry_state.attempt_number >= self.max_attempt_number
- class stop_after_delay(stop_base):
- """Stop when the time from the first attempt >= limit."""
- def __init__(self, max_delay: float) -> None:
- self.max_delay = max_delay
- def __call__(self, retry_state: "RetryCallState") -> bool:
- return retry_state.seconds_since_start >= self.max_delay
|