# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-django-redis
VERSION=		6.0.0
KEYWORDS=		python
VARIANTS=		v13 v14
SDESC[v13]=		Redis cache backend for Django (3.13)
SDESC[v14]=		Redis cache backend for Django (3.14)
HOMEPAGE=		https://github.com/jazzband/django-redis
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/7e/79/055dfcc508cfe9f439d9f453741188d633efa9eab90fc78a67b0ab50b137
DISTFILE[1]=		django_redis-6.0.0-py3-none-any.whl:main
DIST_SUBDIR=		python-src
DF_INDEX=		1
SPKGS[v13]=		single
SPKGS[v14]=		single

OPTIONS_AVAILABLE=	PY313 PY314
OPTIONS_STANDARD=	none
VOPTS[v13]=		PY313=ON PY314=OFF
VOPTS[v14]=		PY313=OFF PY314=ON

DISTNAME=		django_redis-6.0.0.dist-info

GENERATED=		yes

[PY313].RUN_DEPENDS_ON=			python-Django:single:v13
					python-redis:single:v13
[PY313].USES_ON=			python:v13,wheel

[PY314].RUN_DEPENDS_ON=			python-Django:single:v14
					python-redis:single:v14
[PY314].USES_ON=			python:v14,wheel

[FILE:2409:descriptions/desc.single]
==============================
Redis cache backend for Django
==============================

    :alt: Jazzband

   :alt: GitHub Actions

   :alt: Coverage

This is a [Jazzband] project. By contributing you agree
to abide by the [Contributor Code of Conduct
] and follow the [guidelines
].

Introduction
------------

django-redis is a BSD licensed, full featured Redis cache and session
backend
for Django.

Why use django-redis?
~~~~~~~~~~~~~~~~~~~~~

- Uses native redis-py url notation connection strings
- Pluggable clients
- Pluggable parsers
- Pluggable serializers
- Primary/secondary support in the default client
- Comprehensive test suite
- Used in production in several projects as cache and session storage
- Supports infinite timeouts
- Facilities for raw access to Redis client/connection pool
- Highly configurable (can emulate memcached exception behavior, for
example)
- Unix sockets supported by default

Requirements
~~~~~~~~~~~~

- `Python`_ 3.9+
- `Django`_ 4.2+
- `redis-py`_ 4.0.2+
- `Redis server`_ 2.8+

.. _Python: https://www.python.org/downloads/
.. _Django: https://www.djangoproject.com/download/
.. _redis-py: https://pypi.org/project/redis/
.. _Redis server: https://redis.io/download

User guide
----------

Installation
~~~~~~~~~~~~

Install with pip:

.. code-block:: console

    $ python -m pip install django-redis

Configure as cache backend
~~~~~~~~~~~~~~~~~~~~~~~~~~

To start using django-redis, you should change your Django cache settings
to
something like:

.. code-block:: python

    CACHES = {
        "default": {
            "BACKEND": "django_redis.cache.RedisCache",
            "LOCATION": "redis://127.0.0.1:6379/1",
            "OPTIONS": {
                "CLIENT_CLASS": "django_redis.client.DefaultClient",
            }
        }
    }

django-redis uses the redis-py native URL notation for connection strings,
it
allows better interoperability and has a connection string in more
"standard"
way. Some examples:

- ``redis://[[username]:[password]]@localhost:6379/0``
- ``rediss://[[username]:[password]]@localhost:6379/0``
- ``unix://[[username]:[password]]@/path/to/socket.sock?db=0``

Three URL schemes are supported:

- ``redis://``: creates a normal TCP socket connection
- ``rediss://``: creates a SSL wrapped TCP socket connection
- ``unix://`` creates a Unix Domain Socket connection

There are several ways to specify a database number:



[FILE:125:distinfo]
20bf0063a8abee567eb5f77f375143c32810c8700c0674ced34737f8de4e36c0        33687 python-src/django_redis-6.0.0-py3-none-any.whl