yretry 1.0.2

Retries library

Library to make your services reliable

Retry on specific exception

import yretry

@yretry.decorators.retry(attempts_number=3,
                         retry_on=(MyException,))
def reliable_function():
    raise MyException()

Specific function to make decision about retries

import yretry

def is_my_mistake(error):
    return isinstance(error, MyMistake)

@yretry.decorators.retry(attempts_number=3,
                         retry_on=is_my_mistake)
def reliable_function():
    raise MyMistake()

Retry on network errors

You can use following code to add retries for your custom network function:

import requests
import yretry

@yretry.network.retry()
def reliable_function():
   response = requests.get('http://localhost:5002')
   response.raise_for_status()
   return response

print reliable_function()

Logging

Global logger

You can pass specific logger to decorator:

import logging
import logging.config

LOGGING = {
    'version': 1,
    'formatters': {
        'precise': {
            'datefmt': '%Y-%m-%d,%H:%M:%S',
            'format': '%(levelname)-7s %(asctime)15s '
                      '%(name)s:%(lineno)d %(message)s'
        }
    },
    'handlers': {
        'console': {
            'class': 'logging.StreamHandler',
            'formatter': 'precise',
            'stream': 'ext://sys.stderr'
        },
    },
    'root': {
        'level': 'INFO',
        'handlers': ['console']
    }
}

logging.config.dictConfig(LOGGING)

LOGGER = logging.getLogger(__name__)

@yretry.network.retry(logger=LOGGER)
def reliable_function():
   response = requests.get('http://localhost:5002')
   response.raise_for_status()
   return response

Object-specific logger

You can use object-specific logger, just add ‘get_logger’ method:

class MyClass(object):
   def __init__(self):
       self._logger = logging.getLogger(__name__)

   def get_logger(self):
       return self._logger

   @yretry.network.retry()
   def reliable_method(self):
       pass

obj = MyClass()
obj.reliable_method()
# obj._logger will be used to write warnings about retries