Cachalot 
Cachalot is a minimal persistent memoization cache. It provides a decorator, that stores function result for future use. Perfect for heavy computations and I/O operation (such as web requests). On backend, it uses TinyDB for storage.
Features
- Simple usage via decorator
- Persistent caching
- Key expiration
- Maximum cache size, to prevent bloat
Installation
Cachalot requires Python 3.5 or newer to run.
Python package
You can easily install Cachalot using pip:
pip3 install cachalot
Manual
Alternatively, to get the latest development version, you can clone this repository and then manually install it:
git clone git@gitlab.com:radek-sprta/cachalot.git
cd cachalot
python3 setup.py install
Usage
from cachalot import Cache
@Cache()
def expensive_function():
return expensive_calculation()
Advanced usage
from cachalot import Cache
@Cache(path='cache.json', timeout=3600, size=5000)
def expensive_function():
return expensive_calculation()
path: Path to the database file. Defaults to .cache.json.timeout: How long should the data be cached in seconds. Defaults to 86400 (1 day).size: Maximum number of keys cached. Defaults to 10000.
For more information, see documentation.
TODO
- Test suite
- Optionally retry if blank data is returned
Contributing
For information on how to contribute to the project, please check the Contributor's Guide
Contact
incoming+radek-sprta/cachalot@gitlab.com
License
MIT License
Credits
This package was created with Cookiecutter and the python-cookiecutter project template. Inspired by Cashier
1 maintainer
Metadata
1 maintainer
Release files for Cachalot 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| cachalot-0.1.3.tar.gz | 7.4 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cachalot-0.1.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 11.4 kB
Release files / cachalot-0.1.3.tar.gz
| Download URL | cachalot-0.1.3.tar.gz |
|---|---|
| Size | 7.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fb299bdf4d10dea717d6bc5a49adf407b7d11ae9eec98b4f93232236f429096a
|
|
BLAKE2b-256 checksum How to use checksums |
c38737dead994f3010bb2be5f1303f601165ccba85a2f811dccf5dce26223e56
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / cachalot-0.1.3-py3-none-any.whl
| Download URL | cachalot-0.1.3-py3-none-any.whl |
|---|---|
| Size | 4.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4ffa6c8f82256b5b71e0fb41c4316629567a800d80553a2f0a27033cc003676c
|
|
BLAKE2b-256 checksum How to use checksums |
a025ec951f15fa8cefe49feecf4b78015665953ed39dddcf1b6d3f9f6a9652e6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for Cachalot 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
