All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Calendar Versioning.

The first number of the version is the year. The second number is incremented with each release, starting at 1 for each year. The third number is for emergencies when we need to start branches for older releases.

You can find our backwards-compatibility policy here.

23.1.0 - 2023-07-04#


  • Official Python 3.12 support. #9

  • Async support. #10

  • Retries of arbitrary blocks using (async) for loops and context managers. #12

  • Proper documentation. #16

  • A backwards-compatibility policy.


  • The timeout, wait_initial, wait_max, and wait_jitter arguments can now also be of type datetime.timedelta.

22.2.0 - 2022-10-06#


  • Retries are now instrumented. If prometheus-client is installed, retries are counted using the Prometheus counter stamina_retries_total. If structlog is installed, they are logged using a structlog logger at warning level. These two instrumentations are independent from each other.

22.1.0 - 2022-10-02#


  • Initial release.