retrylib 1.0.2

Smart retry library

Library to make code more robust
================================

Retry on specific exception
---------------------------

import retrylib

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


Use custom function
-------------------

import retrylib

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

@retrylib.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 retrylib

@retrylib.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__)

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


Object-specific logger
----------------------

To use object-specific logger define method 'get_logger'

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

def get_logger(self):
return self._logger

@retrylib.network.retry()
def my_method(self):
pass

obj = MyClass()
obj.my_method()
# obj._logger will be used