Skip to main content

Simple LRU cache for asyncio

Project description


Simple lru cache for asyncio


pip install async_lru


This package is 100% port of Python built-in function functools.lru_cache for asyncio

import asyncio

import aiohttp
from async_lru import alru_cache

async def get_pep(num):
    resource = '' % num
    async with aiohttp.ClientSession() as session:
            async with session.get(resource) as s:
                return await
        except aiohttp.ClientError:
            return 'Not Found'

async def main():
    for n in 8, 290, 308, 320, 8, 218, 320, 279, 289, 320, 9991:
        pep = await get_pep(n)
        print(n, len(pep))

    # CacheInfo(hits=3, misses=8, maxsize=32, currsize=8)

    # closing is optional, but highly recommended
    await get_pep.cache_close()

TTL (time-to-live, expiration on timeout) is supported by accepting ttl configuration parameter (off by default):

async def func(arg):
    return arg * 2

The library supports explicit invalidation for specific function call by cache_invalidate():

async def func(arg1, arg2):
    return arg * 2

func.cache_invalidate(1, arg2=2)

The method returns True if corresponding arguments set was cached already, False otherwise.

Python 3.8+ is required


The library was donated by Ocean S.A.

Thanks to the company for contribution.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

async-lru-2.0.2.tar.gz (9.3 kB view hashes)

Uploaded source

Built Distribution

async_lru-2.0.2-py3-none-any.whl (5.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page