Fast, safe, cost-effective DynamoDB cache backend for Django

• django-dynamodb-cache
  • Introduce
  • Why should I use this?
  • Installation
  • Setup on Django
  • Aws credentials
  • Create cache table command
  • Future improvements
  • How to contribute

This project is a cache backend using aws dynamodb.

This is compatible with the django official cache framework.

Did you set the boto3 permission?

Enter the django official command createcachetable and get started easily.

• There are few management points, because dynamodb is a fully managed service.
• Data is safely stored unlike inmemory db.
• Because you only pay for what you use, it saves money on light projects such as side projects or back offices.
• If you need more performance, you can easily switch to DAX.

pip install django-dynamodb-cache

On Django settings.py

INSTALLED_APPS = [
    ...
    "django_dynamodb_cache"
]

CACHES = {
    "default": {
        "BACKEND": "django_dynamodb_cache.backend.DjangoCacheBackend",
        "LOCATION": "table-name",                  # (mandatory)
        "TIMEOUT": 120,                            # (optional) seconds
        "KEY_PREFIX": "django_dynamodb_cache",     # (optional)
        "VERSION": 1,                              # (optional)
        "KEY_FUNCTION": "path.to.function",        # (optional) f"{prefix}:{key}:{version}"
        "OPTIONS": {
            "aws_region_name": "us-east-1",                    # (optional)
            "aws_access_key_id": "aws_access_key_id",          # (optional)
            "aws_secret_access_key": "aws_secret_access_key",  # (optional)
            "is_on_demand": False,                 # (optional) default: True
            "read_capacity_units": 1,              # (optional)
            "write_capacity_units": 1,             # (optional)
            "encode": "django_dynamodb_cache.encode.PickleEncode"  # (optional)
        }
    }
}

The same method as configuring-credentials provided in the boto3 documentation is used. https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html#configuring-credentials

Run manage command to create cache table on Dynamodb before using

python manage.py createcachetable

In this project, the following can be improved in the future.

• A full scan is included to achieve cache.clear(). This can lead to performance degradation when there is a lot of cached data.

This project is welcome to contributions!

Please submit an issue ticket before submitting a patch.

Pull requests are merged into the main branch and should always remain available.

After passing all test code, it is reviewed and merged.