python-backoff 2.2.2rc1__tar.gz → 2.3.0__tar.gz

python_backoff-2.3.0/.gitignore

@@ -0,0 +1,42 @@
+__pycache__/
+*.pyc
+.coverage
+virtualenv
+MANIFEST
+build/
+dist/
+.cache/
+*.egg-info
+.vscode
+.tox/
+coverage.xml
+
+# mkdocs
+site/
+
+# General
+.DS_Store
+__MACOSX/
+.AppleDouble
+.LSOverride
+Icon[
+]
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk

{python_backoff-2.2.2rc1 → python_backoff-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-backoff
-Version: 2.2.2rc1
+Version: 2.3.0
 Summary: Function decoration for backoff and retry
 Project-URL: Documentation, https://python-backoff.github.io/backoff
 Project-URL: Repository, https://github.com/python-backoff/backoff
@@ -16,7 +16,6 @@ Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -28,7 +27,7 @@ Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
-Requires-Python: >=3.7
+Requires-Python: >=3.8
 Description-Content-Type: text/x-rst
 
 backoff
@@ -38,8 +37,8 @@ backoff
     :target: https://github.com/python-backoff/backoff/actions/workflows/ci.yaml
 .. image:: https://github.com/python-backoff/backoff/workflows/CodeQL/badge.svg
     :target: https://github.com/python-backoff/backoff/actions/workflows/codeql-analysis.yml
-.. image:: https://img.shields.io/pypi/v/backoff.svg
-    :target: https://pypi.python.org/pypi/backoff
+.. image:: https://img.shields.io/pypi/v/python-backoff.svg
+    :target: https://pypi.python.org/pypi/python-backoff
 .. image:: https://img.shields.io/github/license/python-backoff/backoff
     :target: https://github.com/python-backoff/backoff/blob/main/LICENSE
 
@@ -201,7 +200,7 @@ gets a non-falsey result could be defined like like this:
     def poll_for_message(queue):
         return queue.get()
 
-The jitter is disabled in order to keep the polling frequency fixed.  
+The jitter is disabled in order to keep the polling frequency fixed.
 
 @backoff.runtime
 ----------------

{python_backoff-2.2.2rc1 → python_backoff-2.3.0}/README.rst

@@ -5,8 +5,8 @@ backoff
     :target: https://github.com/python-backoff/backoff/actions/workflows/ci.yaml
 .. image:: https://github.com/python-backoff/backoff/workflows/CodeQL/badge.svg
     :target: https://github.com/python-backoff/backoff/actions/workflows/codeql-analysis.yml
-.. image:: https://img.shields.io/pypi/v/backoff.svg
-    :target: https://pypi.python.org/pypi/backoff
+.. image:: https://img.shields.io/pypi/v/python-backoff.svg
+    :target: https://pypi.python.org/pypi/python-backoff
 .. image:: https://img.shields.io/github/license/python-backoff/backoff
     :target: https://github.com/python-backoff/backoff/blob/main/LICENSE
 
@@ -168,7 +168,7 @@ gets a non-falsey result could be defined like like this:
     def poll_for_message(queue):
         return queue.get()
 
-The jitter is disabled in order to keep the polling frequency fixed.  
+The jitter is disabled in order to keep the polling frequency fixed.
 
 @backoff.runtime
 ----------------

{python_backoff-2.2.2rc1 → python_backoff-2.3.0}/backoff/_async.py

@@ -1,11 +1,10 @@
 # coding:utf-8
-import datetime
-import functools
 import asyncio
+import functools
 import inspect
-from datetime import timedelta
+import time
 
-from backoff._common import (_init_wait_gen, _maybe_call, _next_wait)
+from backoff._common import _init_wait_gen, _maybe_call, _next_wait
 
 
 def _ensure_coroutine(coro_or_func):
@@ -61,11 +60,11 @@ def retry_predicate(target, wait_gen, predicate,
         max_time_value = _maybe_call(max_time)
 
         tries = 0
-        start = datetime.datetime.now()
+        start = time.monotonic()
         wait = _init_wait_gen(wait_gen, wait_gen_kwargs)
         while True:
             tries += 1
-            elapsed = timedelta.total_seconds(datetime.datetime.now() - start)
+            elapsed = time.monotonic() - start
             details = {
                 "target": target,
                 "args": args,
@@ -135,11 +134,11 @@ def retry_exception(target, wait_gen, exception,
         max_time_value = _maybe_call(max_time)
 
         tries = 0
-        start = datetime.datetime.now()
+        start = time.monotonic()
         wait = _init_wait_gen(wait_gen, wait_gen_kwargs)
         while True:
             tries += 1
-            elapsed = timedelta.total_seconds(datetime.datetime.now() - start)
+            elapsed = time.monotonic() - start
             details = {
                 "target": target,
                 "args": args,

{python_backoff-2.2.2rc1 → python_backoff-2.3.0}/backoff/_common.py

@@ -65,14 +65,14 @@ def _prepare_logger(logger):
 # Configure handler list with user specified handler and optionally
 # with a default handler bound to the specified logger.
 def _config_handlers(
-    user_handlers, *, default_handler=None, logger=None, log_level=None
+    user_handlers, *, default_handler=None, logger=None, log_level=None,
 ):
     handlers = []
     if logger is not None:
         assert log_level is not None, "Log level is not specified"
         # bind the specified logger to the default log handler
         log_handler = functools.partial(
-            default_handler, logger=logger, log_level=log_level
+            default_handler, logger=logger, log_level=log_level,
         )
         handlers.append(log_handler)
 

{python_backoff-2.2.2rc1 → python_backoff-2.3.0}/backoff/_decorator.py

@@ -8,7 +8,7 @@ from backoff._common import (
     _prepare_logger,
     _config_handlers,
     _log_backoff,
-    _log_giveup
+    _log_giveup,
 )
 from backoff._jitter import full_jitter
 from backoff import _async, _sync
@@ -89,13 +89,13 @@ def on_predicate(wait_gen: _WaitGenerator,
             on_backoff,
             default_handler=_log_backoff,
             logger=logger,
-            log_level=backoff_log_level
+            log_level=backoff_log_level,
         )
         on_giveup = _config_handlers(
             on_giveup,
             default_handler=_log_giveup,
             logger=logger,
-            log_level=giveup_log_level
+            log_level=giveup_log_level,
         )
 
         if inspect.iscoroutinefunction(target):
@@ -113,7 +113,7 @@ def on_predicate(wait_gen: _WaitGenerator,
             on_success=on_success,
             on_backoff=on_backoff,
             on_giveup=on_giveup,
-            wait_gen_kwargs=wait_gen_kwargs
+            wait_gen_kwargs=wait_gen_kwargs,
         )
 
     # Return a function which decorates a target with a retry loop.
@@ -215,7 +215,7 @@ def on_exception(wait_gen: _WaitGenerator,
             on_backoff=on_backoff,
             on_giveup=on_giveup,
             raise_on_giveup=raise_on_giveup,
-            wait_gen_kwargs=wait_gen_kwargs
+            wait_gen_kwargs=wait_gen_kwargs,
         )
 
     # Return a function which decorates a target with a retry loop.

{python_backoff-2.2.2rc1 → python_backoff-2.3.0}/backoff/_sync.py

@@ -1,8 +1,6 @@
 # coding:utf-8
-import datetime
 import functools
 import time
-from datetime import timedelta
 
 from backoff._common import (_init_wait_gen, _maybe_call, _next_wait)
 
@@ -32,11 +30,11 @@ def retry_predicate(target, wait_gen, predicate,
         max_time_value = _maybe_call(max_time)
 
         tries = 0
-        start = datetime.datetime.now()
+        start = time.monotonic()
         wait = _init_wait_gen(wait_gen, wait_gen_kwargs)
         while True:
             tries += 1
-            elapsed = timedelta.total_seconds(datetime.datetime.now() - start)
+            elapsed = time.monotonic() - start
             details = {
                 "target": target,
                 "args": args,
@@ -88,11 +86,11 @@ def retry_exception(target, wait_gen, exception,
         max_time_value = _maybe_call(max_time)
 
         tries = 0
-        start = datetime.datetime.now()
+        start = time.monotonic()
         wait = _init_wait_gen(wait_gen, wait_gen_kwargs)
         while True:
             tries += 1
-            elapsed = timedelta.total_seconds(datetime.datetime.now() - start)
+            elapsed = time.monotonic() - start
             details = {
                 "target": target,
                 "args": args,

{python_backoff-2.2.2rc1 → python_backoff-2.3.0}/backoff/_wait_gen.py

@@ -8,7 +8,7 @@ from typing import Any, Callable, Generator, Iterable, Optional, Union
 def expo(
     base: float = 2,
     factor: float = 1,
-    max_value: Optional[float] = None
+    max_value: Optional[float] = None,
 ) -> Generator[float, Any, None]:
 
     """Generator for exponential decay.
@@ -22,12 +22,12 @@ def expo(
     """
     # Advance past initial .send() call
     yield  # type: ignore[misc]
-    n = 0
+    base_n: float = 1
     while True:
-        a = factor * base ** n
+        a = factor * base_n
         if max_value is None or a < max_value:
             yield a
-            n += 1
+            base_n *= base
         else:
             yield max_value
 
@@ -35,7 +35,7 @@ def expo(
 def decay(
     initial_value: float = 1,
     decay_factor: float = 1,
-    min_value: Optional[float] = None
+    min_value: Optional[float] = None,
 ) -> Generator[float, Any, None]:
 
     """Generator for exponential decay[1]:
@@ -83,7 +83,7 @@ def fibo(max_value: Optional[int] = None) -> Generator[int, None, None]:
 
 
 def constant(
-    interval: Union[int, Iterable[float]] = 1
+    interval: Union[int, Iterable[float]] = 1,
 ) -> Generator[float, None, None]:
     """Generator for constant intervals.
 
@@ -104,7 +104,7 @@ def constant(
 
 def runtime(
     *,
-    value: Callable[[Any], float]
+    value: Callable[[Any], float],
 ) -> Generator[float, None, None]:
     """Generator that is based on parsing the return value or thrown
         exception of the decorated method

{python_backoff-2.2.2rc1 → python_backoff-2.3.0}/backoff/types.py

@@ -2,5 +2,5 @@
 from ._typing import Details
 
 __all__ = [
-    'Details'
+    'Details',
 ]

{python_backoff-2.2.2rc1 → python_backoff-2.3.0}/pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "python-backoff"
-version = "2.2.2rc1"
+version = "2.3.0"
 description = "Function decoration for backoff and retry"
 authors = [{ name = "Bob Green", email = "rgreen@aquent.com" }]
 maintainers = [{ name = "Edgar Ramírez-Mondragón", email = "edgarrm358@gmail.com" }]
-requires-python = ">=3.7"
+requires-python = ">=3.8"
 readme = "README.rst"
 license = "MIT"
 keywords = [
@@ -20,7 +20,6 @@ classifiers = [
     "Operating System :: OS Independent",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.7",
     "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
@@ -77,7 +76,6 @@ min_version = "4.22"
 requires = [ "tox", "tox-gh", "tox-uv" ]
 env_list = [
   "format",
-  "3.7",
   "3.8",
   "3.9",
   "3.10",
@@ -101,7 +99,6 @@ commands = [
 [tool.tox.env.coverage]
 description = "generate coverage report"
 depends = [
-  "3.7",
   "3.8",
   "3.9",
   "3.10",
@@ -123,6 +120,7 @@ description = "format code"
 dependency_groups = [ "lint" ]
 commands = [
     [ "ruff", "check", "--fix", { replace = "posargs", default = [ "backoff", "tests" ], extend = true } ],
+    # [ "ruff", "format", { replace = "posargs", default = [ "backoff", "tests" ], extend = true } ],
 ]
 
 [tool.tox.env.lint]
@@ -155,7 +153,6 @@ commands = [
 "3.10" = ["3.10"]
 "3.9" = ["3.9"]
 "3.8" = ["3.8"]
-"3.7" = ["3.7"]
 
 [tool.pytest.ini_options]
 filterwarnings = [
@@ -183,6 +180,11 @@ source = [
   "backoff",
 ]
 
+[tool.ruff.lint]
+extend-select = [
+  "COM",  # flake8-commas
+]
+
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"

{python_backoff-2.2.2rc1 → python_backoff-2.3.0}/tests/test_backoff.py

@@ -1,5 +1,4 @@
 # coding:utf-8
-import datetime
 import itertools
 import logging
 import random
@@ -47,19 +46,17 @@ def test_on_predicate_max_tries(monkeypatch):
 
 def test_on_predicate_max_time(monkeypatch):
     nows = [
-        datetime.datetime(2018, 1, 1, 12, 0, 10, 5),
-        datetime.datetime(2018, 1, 1, 12, 0, 9, 0),
-        datetime.datetime(2018, 1, 1, 12, 0, 1, 0),
-        datetime.datetime(2018, 1, 1, 12, 0, 0, 0),
+        10.000005,
+        9,
+        1,
+        0,
     ]
 
-    class Datetime:
-        @staticmethod
-        def now():
-            return nows.pop()
+    def monotonic():
+        return nows.pop()
 
     monkeypatch.setattr('time.sleep', lambda x: None)
-    monkeypatch.setattr('datetime.datetime', Datetime)
+    monkeypatch.setattr('time.monotonic', monotonic)
 
     def giveup(details):
         assert details['tries'] == 3
@@ -80,19 +77,17 @@ def test_on_predicate_max_time(monkeypatch):
 
 def test_on_predicate_max_time_callable(monkeypatch):
     nows = [
-        datetime.datetime(2018, 1, 1, 12, 0, 10, 5),
-        datetime.datetime(2018, 1, 1, 12, 0, 9, 0),
-        datetime.datetime(2018, 1, 1, 12, 0, 1, 0),
-        datetime.datetime(2018, 1, 1, 12, 0, 0, 0),
+        10.000005,
+        9,
+        1,
+        0,
     ]
 
-    class Datetime:
-        @staticmethod
-        def now():
-            return nows.pop()
+    def monotonic():
+        return nows.pop()
 
     monkeypatch.setattr('time.sleep', lambda x: None)
-    monkeypatch.setattr('datetime.datetime', Datetime)
+    monkeypatch.setattr('time.monotonic', monotonic)
 
     def giveup(details):
         assert details['tries'] == 3
@@ -502,7 +497,6 @@ def test_on_predicate_iterable_handlers():
         assert len(logger.giveups) == 1
 
         details = dict(logger.giveups[0])
-        print(details)
         elapsed = details.pop('elapsed')
         assert isinstance(elapsed, float)
         assert details == {'args': (1, 2, 3),
@@ -591,7 +585,6 @@ def test_on_predicate_success_0_arg_jitter(monkeypatch):
 
     for i in range(2):
         details = backoffs[i]
-        print(details)
         elapsed = details.pop('elapsed')
         assert isinstance(elapsed, float)
         assert details == {'args': (1, 2, 3),
@@ -847,7 +840,7 @@ def test_on_exception_logger_user_str(monkeypatch, caplog):
 
 
 def _on_exception_factory(
-    backoff_log_level, giveup_log_level, max_tries
+    backoff_log_level, giveup_log_level, max_tries,
 ):
     @backoff.on_exception(
         backoff.expo,
@@ -867,7 +860,7 @@ def _on_exception_factory(
 
 
 def _on_predicate_factory(
-    backoff_log_level, giveup_log_level, max_tries
+    backoff_log_level, giveup_log_level, max_tries,
 ):
     @backoff.on_predicate(
         backoff.expo,
@@ -896,17 +889,17 @@ def _on_predicate_factory(
             repeat=2,
         )
         for factory in (_on_predicate_factory, _on_exception_factory)
-    )
+    ),
 )
 def test_event_log_levels(
-    caplog, func_factory, backoff_log_level, giveup_log_level
+    caplog, func_factory, backoff_log_level, giveup_log_level,
 ):
     max_tries = 3
     func = func_factory(backoff_log_level, giveup_log_level, max_tries)
 
     with unittest.mock.patch('time.sleep', return_value=None):
         with caplog.at_level(
-            min(backoff_log_level, giveup_log_level), logger="backoff"
+            min(backoff_log_level, giveup_log_level), logger="backoff",
         ):
             func()
 

{python_backoff-2.2.2rc1 → python_backoff-2.3.0}/tests/test_typing.py

@@ -18,7 +18,7 @@ def foo():
     backoff.constant,
     ValueError,
     interval=1,
-    max_tries=3
+    max_tries=3,
 )
 def bar():
     raise ValueError()

{python_backoff-2.2.2rc1 → python_backoff-2.3.0}/tests/test_wait_gen.py

@@ -67,6 +67,14 @@ def test_expo_max_value():
         assert expect == next(gen)
 
 
+def test_expo_max_value_factor():
+    gen = backoff.expo(factor=3, max_value=2 ** 4)
+    gen.send(None)
+    expected = [3 * 1, 3 * 2, 3 * 4, 16, 16, 16, 16]
+    for expect in expected:
+        assert expect == next(gen)
+
+
 def test_fibo():
     gen = backoff.fibo()
     gen.send(None)

python_backoff-2.2.2rc1/.gitignore

@@ -1,15 +0,0 @@
-__pycache__/
-*.pyc
-.coverage
-virtualenv
-MANIFEST
-build/
-dist/
-.cache/
-*.egg-info
-.vscode
-.tox/
-coverage.xml
-
-# mkdocs
-site/