flask-api-cache 0.0.4

A tool for flask api cache with args

Flask Api Cache

A package for caching flask api with full request path as key.

Description:

A decorator for python flask api.

You can set cache in your memory or with redis server,
the key will be generated by the following rule:
{YOUR_FUNCTION_NAME}:{REQUEST_FULL_PATH}
or you can pass your custom key function by key_func args,
the value will be your function return value.

How To Use:

Cache Without Redis

@app.route('/')
@ApiCache(expired_time=10)
def index(*args, **kwargs):
    name = request.args.get('name')
    age = request.args.get('age')
    return f'{name} is {age} years old.'

If you request for http://0.0.0.0:5000?name=Jimmy&age=18,
it will set a 10 seconds data cache by key: name=Jimmy&age=18,
with value: Jimmy is 18 years old., in your memory, it will be cleared after service restart.

Cache With Redis

@app.route('/')
@ApiCache(redis=REDIS_INSTANCE, expired_time=10)
def index(*args, **kwargs):
    name = request.args.get('name')
    age = request.args.get('age')
    return f'{name} is {age} years old.'

If you request for http://0.0.0.0:5000?name=Jimmy&age=18,
it will set a 10 seconds data cache by key: name=Jimmy&age=18,
with value: Jimmy is 18 years old., in your redis_instance.

Cache With Custom Function

def custom_func():
    # today is 2020-07-21
    return f'my_key:{datetime.datetime.noe().date()}'

@app.route('/')
@ApiCache(key_func=custom_func, expired_time=10)
def index(*args, **kwargs):
    name = request.args.get('name')
    age = request.args.get('age')
    return f'{name} is {age} years old.'

If you request for http://0.0.0.0:5000?name=Jimmy&age=18,
it will set a 10 seconds data cache by key: my_key:2020-07-21,
with value: Jimmy is 18 years old., in your memory, it will be cleared after service restart.

Parameters

name	required	description
redis	no	if you want to caching data in redis, you and call ApiCache with a redis instance.
expired_time	no	set your expired time with seconds, the default value is 24 * 60 * 60 seconds (1 days)
key_func	no	the function which you want to make custom key