معرفی شرکت ها
cache-money-1.2.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Async cache decorator for memoization using aioredis.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | cache-money-1.2.0 |
| نام | cache-money |
| نسخه کتابخانه | 1.2.0 |
| نگهدارنده | ['Alexandre Jutras'] |
| ایمیل نگهدارنده | ['alexandre.jutras@novisto.com'] |
| نویسنده | Alexandre Jutras |
| ایمیل نویسنده | alexandre.jutras@novisto.com |
| آدرس صفحه اصلی | https://github.com/novisto/cache-money |
| آدرس اینترنتی | https://pypi.org/project/cache-money/ |
| مجوز | MIT |
# Cache Money
[](https://dev.azure.com/novisto/novisto/_build/latest?definitionId=30&branchName=master)
[](https://codecov.io/gh/novisto/cache-money)
[](https://pypi.org/project/cache-money/)
[](https://pypi.org/project/cache-money/)
Async cache library for [memoization](https://en.wikipedia.org/wiki/Memoization) using Redis. Inspired by
[Walrus](https://github.com/coleifer/walrus) and implemented with [aioredis](https://github.com/aio-libs/aioredis-py).
Cache Money is used through a decorator you can add to your function that needs to be cached. When the decorator
gets executed, Cache Money will make a unique key from the name of the function and the params received and look up in
redis if there is a result for this key. If there is a result it will be used as the output of the function and the
execution of the function will be skipped.
You can add a timeout in the declaration of the decorator, you can find constants for common timeout duration in
`cache_money/constants.py`. When the timeout is reached, Redis remove the entry itself.
It's also possible to clear the cache early by using the method bust that gets added to a function decorated by
Cache Money. An example is provided below.
This library is available on PyPI under the name cache-money. You can install with pip by running `pip install
cache-money`.
# Requirements
You need a redis instance running to use this library. This library was tested to run on version of Redis >= 4.0.0.
If you have docker set up you can create a redis instance like this:
```shell
make redis-start
```
# Usage
## Basic usage
First thing is initializing Cache Money and decorating a function that you want to cache
```python
from cache_money import cache_money, init_cache_money
from cache_money.constants import CACHE_HOUR, CACHE_WEEK
init_cache_money(host="localhost")
@cache_money.cached(timeout=CACHE_HOUR)
async def addition(x: int, y: int) -> int:
return x + y
@cache_money.cached(timeout=CACHE_WEEK)
async def multiplication(x: int, y: int) -> int:
return x * y
```
If you run the following calls to the function `addition` consecutively:
```doctest
>>> await addition(3, 4)
7
>>> await addition(3, 7)
10
>>> await addition(3, 4)
7
```
The first and second call would be executed, but the third call would have used the cache in redis instead, as long
as the third call was done within one hour of when the first call was made, as the function addition is caching results
for one hour.
In Redis you would see two entries like this:
```shell
# redis-cli
127.0.0.1:6379> KEYS *
1) "__main__:addition:ea53056bad64a599c84efdfd4f4cbb64"
2) "__main__:addition:bb6b7afb6a6cf3191f6d7fd35d976d42"
127.0.0.1:6379> TTL addition:ea53056bad64a599c84efdfd4f4cbb64
(integer) 3403
```
## Busting cache for a specific function call
You can force expire (bust) the cache for a specific function call
```doctest
>> await addition(3, 4)
>> await addition(3, 7)
>> await addition.bust(3, 4)
```
In Redis you would see one entry as the other one has been busted
```shell
127.0.0.1:6379> KEYS *
1) "__main__:addition:bb6b7afb6a6cf3191f6d7fd35d976d42"
```
## Busting cache for all function calls of a specific function
You can bust the cache for all instance of a function call
```doctest
>> await addition(3, 4)
>> await addition(3, 7)
>> await multiplication(2, 4)
>> await addition.bust_all()
```
In Redis you would see no entries for the function `addition` which has been busted,
you would see one entry for `multiplication`
```shell
127.0.0.1:6379> KEYS *
1) "__main__:multiplication:bc3b7afc6a7cf3191f6d1fd31d810d55"
```
## Busting cache for all function calls of all functions
You can bust the cache of all entries made by Cache Money as well
```doctest
>> await addition(3, 4)
>> await addition(3, 7)
>> await multiplication(2, 4)
>> cache_money.bust()
```
In Redis you would see no entries
```shell
127.0.0.1:6379> KEYS *
(empty array)
```
## Contributing and getting set up for local development
To set yourself up for development on Cache Money, make sure you are using
[poetry](https://poetry.eustace.io/docs/) and simply run the following commands from the root directory:
```shell
make sys-deps
make install
```
نیازمندی
| مقدار | نام |
|---|---|
| >=4.5.1,<5.0.0 | redis |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.8.1,<3.12 | Python |
نحوه نصب
نصب پکیج whl cache-money-1.2.0:
pip install cache-money-1.2.0.whl
نصب پکیج tar.gz cache-money-1.2.0:
pip install cache-money-1.2.0.tar.gz