# Redislite
[](https://screwdriver.cd/)
[](https://cd.screwdriver.cd/pipelines/2880)
[](https://www.python.org/dev/peps/pep-0008/)
[](https://codecov.io/gh/yahoo/redislite)
[](https://pypi.python.org/pypi/redislite/)
[](https://pypi.python.org/pypi/redislite/)
[](https://pypi.python.org/pypi/redislite/)
[](http://redislite.readthedocs.org/en/latest/)
## Description
Redislite is a self contained Python interface to the Redis key-value store.
It provides enhanced versions of the Redis-Py Python bindings for Redis. That provide the following added functionality:
* **Easy to use** - It provides a built in Redis server that is automatically installed, configured and managed when the Redis bindings are used.
* **Flexible** - Create a single server shared by multiple programs or multiple independent servers. All the servers provided by Redislite support all Redis functionality including advanced features such as replication and clustering.
* **Compatible** - It provides enhanced versions of the Redis-Py python Redis bindings as well as functions to patch them to allow most existing code that uses them to run with little or no modifications.
* **Secure** - It uses a secure default Redis configuraton that is only accessible by the creating user on the computer system it is run on.
## Requirements
The redislite module requires Python 3.6 or higher.
### Installing requirements on Linux
Make sure Python development headers are available when installing redislite.
On Ubuntu/Debian systems, install them with:
`apt-get install python-dev`
On Redhat/Fedora systems, install them with:
`yum install python-devel`
### Installing requirements on Mac OSX
Redislite for OSX comes as a wheel package by default that can be installed
using current versions of pip.
To install Redislite on MacOSX using the sdist package instead you will need
the XCode command line utilities installed. If you do not have xcode
installed on recent OSX releases they can be installed by
running:
`xcode-select --install`
### Installing requirements on Microsoft Windows
Redislite can be installed on newer releases of Windows 10 under the Bash on Ubuntu shell.
Install it using the instructions at https://msdn.microsoft.com/commandline/wsl/install_guide
Then start the bash shell and install the python-dev package as follows:
`apt-get install python-dev`
## Installation
To install redislite, simply:
```console
$ pip install redislite
```
or from source:
```console
$ python setup.py install
```
## Getting Started
redislite provides enhanced versions of the redis-py redis.Redis() and
redis.StrictRedis() classes that take the same arguments as the corresponding
redis classes and take one additional optional argument. Which is the
name of the Redis rdb file to use. If the argument is not provided it will
create set up a new redis server.
redislite also provides functions to MonkeyPatch the redis.Redis and
redis.StrictRedis classes to use redislite, so existing python code that uses
Redis can use the redislite version.
## Examples
Here are some examples of using the redislite module.
### Setting a value
Here we open a Python shell and set a key in our embedded Redis db. Redislite will automatically start the Redis server when
the Redis() object is created and shut it down cleanly when the Python interpreter exits.
```python
>>> from redislite import Redis
>>> redis_connection = Redis('/tmp/redis.db')
>>> redis_connection.keys()
[]
>>> redis_connection.set('key', 'value')
True
>>> redis_connection.get('key')
'value'
```
### Persistence
Now we open the same Redis db and access the key we created during the last run. Redislite will automatically start the
Redis server using the same configuration as last time, so the value that was set in the previous example is still available.
```python
>>> from redislite import Redis
>>> redis_connection = Redis('/tmp/redis.db')
>>> redis_connection.keys()
['key']
>>> redis_connection.get('key')
'value'
```
## Compatibility
It's possible to MonkeyPatch the normal Redis classes to allow modules
that use Redis to use the redislite classes. Here we patch Redis and use the
redis_collections module.
```python
>>> import redislite.patch
>>> redislite.patch.patch_redis()
>>> import redis_collections
>>> td = redis_collections.Dict()
>>> td['foo']='bar'
>>> td.keys()
['foo']
```
## Running and using Multiple servers
Redislite will start a new server if the redis rdb fileame isn't specified or is new. In this example we start 10 seperate redis servers and set the value of the key 'servernumber' to a different value in each server.
Then we access the value of 'servernumber' and print it.
```python
>>> import redislite
>>> servers = {}
>>> for redis_server_number in range(10):
... servers[redis_server_number] = redislite.Redis()
... servers[redis_server_number].set('servernumber', redis_server_number)
...
True
True
True
True
True
True
True
True
True
True
>>> for redis_server in servers.values():
... redis_server.get('servernumber')
...
b'0'
b'1'
b'2'
b'3'
b'4'
b'5'
b'6'
b'7'
b'8'
b'9'
```
## Multiple Servers with different configurations in the same script
It's possible to spin up multiple instances with different
configuration settings for the Redis server. Here is an example that sets up 2
redis server instances. One instance is configured to listen on port 8002, the
second instance is a read-only slave of the first instance.
```python
>>> import redislite
>>> master=redislite.Redis(serverconfig={'port': '8002'})
>>> slave=redislite.Redis(serverconfig={'slaveof': "127.0.0.1 8002"})
>>> slave.keys()
[]
>>> master.set('key', 'value')
True
>>> master.keys()
['key']
>>> slave.keys()
['key']
>>>
```
## More Information
There is more detailed information on the redislite documentation page at
http://redislite.readthedocs.org/en/latest/
Redislite is Free software under the New BSD license, see LICENSE.txt for
details.
Raw data
{
"_id": null,
"home_page": "https://github.com/yahoo/redislite",
"name": "redislite",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8.0",
"maintainer_email": "",
"keywords": "redis sqlite python service integrated",
"author": "Verizon Media Python Platform Team",
"author_email": "254983+dwighthubbard@users.noreply.github.com",
"download_url": "https://files.pythonhosted.org/packages/af/7d/b6fc82af45ed2aa31f6c8b2035df009ff9fd8be01ad8a691155cc167f1f2/redislite-6.2.912183.tar.gz",
"platform": null,
"description": "# Redislite\n\n[](https://screwdriver.cd/)\n[](https://cd.screwdriver.cd/pipelines/2880)\n[](https://www.python.org/dev/peps/pep-0008/)\n[](https://codecov.io/gh/yahoo/redislite)\n[](https://pypi.python.org/pypi/redislite/)\n[](https://pypi.python.org/pypi/redislite/)\n[](https://pypi.python.org/pypi/redislite/)\n[](http://redislite.readthedocs.org/en/latest/)\n\n\n## Description\n\nRedislite is a self contained Python interface to the Redis key-value store.\n\nIt provides enhanced versions of the Redis-Py Python bindings for Redis. That provide the following added functionality:\n\n* **Easy to use** - It provides a built in Redis server that is automatically installed, configured and managed when the Redis bindings are used.\n* **Flexible** - Create a single server shared by multiple programs or multiple independent servers. All the servers provided by Redislite support all Redis functionality including advanced features such as replication and clustering.\n* **Compatible** - It provides enhanced versions of the Redis-Py python Redis bindings as well as functions to patch them to allow most existing code that uses them to run with little or no modifications.\n* **Secure** - It uses a secure default Redis configuraton that is only accessible by the creating user on the computer system it is run on.\n\n## Requirements\n\nThe redislite module requires Python 3.6 or higher.\n\n\n### Installing requirements on Linux\n\nMake sure Python development headers are available when installing redislite.\n\nOn Ubuntu/Debian systems, install them with:\n\n`apt-get install python-dev`\n\nOn Redhat/Fedora systems, install them with:\n\n`yum install python-devel`\n\n### Installing requirements on Mac OSX\n\nRedislite for OSX comes as a wheel package by default that can be installed\nusing current versions of pip.\n\nTo install Redislite on MacOSX using the sdist package instead you will need\nthe XCode command line utilities installed. If you do not have xcode\ninstalled on recent OSX releases they can be installed by\nrunning:\n\n`xcode-select --install`\n\n### Installing requirements on Microsoft Windows\n\nRedislite can be installed on newer releases of Windows 10 under the Bash on Ubuntu shell.\n\nInstall it using the instructions at https://msdn.microsoft.com/commandline/wsl/install_guide \n\nThen start the bash shell and install the python-dev package as follows:\n\n`apt-get install python-dev` \n \n## Installation\n\nTo install redislite, simply:\n\n```console\n$ pip install redislite\n```\n\nor from source:\n\n```console\n$ python setup.py install\n```\n\n\n## Getting Started\n\nredislite provides enhanced versions of the redis-py redis.Redis() and \nredis.StrictRedis() classes that take the same arguments as the corresponding\nredis classes and take one additional optional argument. Which is the\nname of the Redis rdb file to use. If the argument is not provided it will\ncreate set up a new redis server.\n\nredislite also provides functions to MonkeyPatch the redis.Redis and \nredis.StrictRedis classes to use redislite, so existing python code that uses\nRedis can use the redislite version.\n \n## Examples\n\nHere are some examples of using the redislite module.\n\n### Setting a value\n\nHere we open a Python shell and set a key in our embedded Redis db. Redislite will automatically start the Redis server when\nthe Redis() object is created and shut it down cleanly when the Python interpreter exits.\n\n```python\n>>> from redislite import Redis\n>>> redis_connection = Redis('/tmp/redis.db')\n>>> redis_connection.keys()\n[]\n>>> redis_connection.set('key', 'value')\nTrue\n>>> redis_connection.get('key')\n'value'\n```\n\n### Persistence\n\nNow we open the same Redis db and access the key we created during the last run. Redislite will automatically start the\nRedis server using the same configuration as last time, so the value that was set in the previous example is still available.\n\n```python\n>>> from redislite import Redis\n>>> redis_connection = Redis('/tmp/redis.db')\n>>> redis_connection.keys()\n['key']\n>>> redis_connection.get('key')\n'value'\n```\n\n## Compatibility\n\nIt's possible to MonkeyPatch the normal Redis classes to allow modules \nthat use Redis to use the redislite classes. Here we patch Redis and use the \nredis_collections module.\n\n```python\n>>> import redislite.patch\n>>> redislite.patch.patch_redis()\n>>> import redis_collections\n>>> td = redis_collections.Dict()\n>>> td['foo']='bar'\n>>> td.keys()\n['foo']\n```\n\n## Running and using Multiple servers\n\nRedislite will start a new server if the redis rdb fileame isn't specified or is new. In this example we start 10 seperate redis servers and set the value of the key 'servernumber' to a different value in each server. \n\nThen we access the value of 'servernumber' and print it.\n\n```python\n>>> import redislite\n>>> servers = {}\n>>> for redis_server_number in range(10):\n... servers[redis_server_number] = redislite.Redis()\n... servers[redis_server_number].set('servernumber', redis_server_number)\n...\nTrue\nTrue\nTrue\nTrue\nTrue\nTrue\nTrue\nTrue\nTrue\nTrue\n>>> for redis_server in servers.values():\n... redis_server.get('servernumber')\n...\nb'0'\nb'1'\nb'2'\nb'3'\nb'4'\nb'5'\nb'6'\nb'7'\nb'8'\nb'9'\n```\n\n## Multiple Servers with different configurations in the same script\n\nIt's possible to spin up multiple instances with different\nconfiguration settings for the Redis server. Here is an example that sets up 2\nredis server instances. One instance is configured to listen on port 8002, the\nsecond instance is a read-only slave of the first instance.\n\n\n```python\n>>> import redislite\n>>> master=redislite.Redis(serverconfig={'port': '8002'})\n>>> slave=redislite.Redis(serverconfig={'slaveof': \"127.0.0.1 8002\"})\n>>> slave.keys()\n[]\n>>> master.set('key', 'value')\nTrue\n>>> master.keys()\n['key']\n>>> slave.keys()\n['key']\n>>>\n```\n\n## More Information\n\nThere is more detailed information on the redislite documentation page at\nhttp://redislite.readthedocs.org/en/latest/\n\nRedislite is Free software under the New BSD license, see LICENSE.txt for\ndetails.\n",
"bugtrack_url": null,
"license": "BSD License",
"summary": "Redis built into a python package",
"version": "6.2.912183",
"project_urls": {
"CI Pipeline": "https://cd.screwdriver.cd/pipelines/2880/events",
"Documentation": "https://redislite.readthedocs.io/en/latest/",
"Homepage": "https://github.com/yahoo/redislite",
"Source": "https://github.com/yahoo/redislite"
},
"split_keywords": [
"redis",
"sqlite",
"python",
"service",
"integrated"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9c07255f52ac6ed075f0ae9c9ecbdb7247853c30fc7bbbd3e78f5560085906b9",
"md5": "ea1ddb0bbf5e76f3efbb54d136c339bd",
"sha256": "830cdb0551ba54ebb3f7b846361a406297d83599b12d46cfab68943421adeac7"
},
"downloads": -1,
"filename": "redislite-6.2.912183-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "ea1ddb0bbf5e76f3efbb54d136c339bd",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": ">=3.8.0",
"size": 6071180,
"upload_time": "2023-12-01T22:22:07",
"upload_time_iso_8601": "2023-12-01T22:22:07.011936Z",
"url": "https://files.pythonhosted.org/packages/9c/07/255f52ac6ed075f0ae9c9ecbdb7247853c30fc7bbbd3e78f5560085906b9/redislite-6.2.912183-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "212f13e658f12163e716557d057bd7975dcef3b048dc03424418cc1e7b5f6b63",
"md5": "232dad0b881cd23ea0133cfd6e4eb02f",
"sha256": "d5ed8af4d03225a9b19e279d40f8d8feae872f87a9cd9f017751864fe7b224c6"
},
"downloads": -1,
"filename": "redislite-6.2.912183-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "232dad0b881cd23ea0133cfd6e4eb02f",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": ">=3.8.0",
"size": 6071179,
"upload_time": "2023-12-01T22:22:10",
"upload_time_iso_8601": "2023-12-01T22:22:10.733733Z",
"url": "https://files.pythonhosted.org/packages/21/2f/13e658f12163e716557d057bd7975dcef3b048dc03424418cc1e7b5f6b63/redislite-6.2.912183-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0bb995ce807b397428704bfc01769848d0caa8417e7d3753785ccc14c3b05097",
"md5": "f72464e8b6a45572e15852f9bb2f588b",
"sha256": "6610f867c2c1b2022613c093d56cfe8293bdf6e081d2259d62b5f5318487c30e"
},
"downloads": -1,
"filename": "redislite-6.2.912183-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "f72464e8b6a45572e15852f9bb2f588b",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": ">=3.8.0",
"size": 6071189,
"upload_time": "2023-12-01T22:22:13",
"upload_time_iso_8601": "2023-12-01T22:22:13.983971Z",
"url": "https://files.pythonhosted.org/packages/0b/b9/95ce807b397428704bfc01769848d0caa8417e7d3753785ccc14c3b05097/redislite-6.2.912183-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c8c4043fbcb1dacf09d5d11ae903e7e02e9527e83a0f2a39201a7b0047e49c11",
"md5": "4328e73bf691fc4613b7f8f7c2bbc41a",
"sha256": "17329cb71bd2e20caf2bdbed141b95e47c5754e12fad66241a6477a3e45f8a8d"
},
"downloads": -1,
"filename": "redislite-6.2.912183-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "4328e73bf691fc4613b7f8f7c2bbc41a",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": ">=3.8.0",
"size": 6071173,
"upload_time": "2023-12-01T22:22:17",
"upload_time_iso_8601": "2023-12-01T22:22:17.738673Z",
"url": "https://files.pythonhosted.org/packages/c8/c4/043fbcb1dacf09d5d11ae903e7e02e9527e83a0f2a39201a7b0047e49c11/redislite-6.2.912183-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fc8e143439ae8518f362e5785006fc48834e232ed9601ce58ae8a26b878744d3",
"md5": "5f34c3dc5203e8bfdd3ee4d605bc0778",
"sha256": "5194556dd991515d70cbb5671d7d28ea02e37ee1f82bc684c2fef0138469ae78"
},
"downloads": -1,
"filename": "redislite-6.2.912183-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "5f34c3dc5203e8bfdd3ee4d605bc0778",
"packagetype": "bdist_wheel",
"python_version": "cp39",
"requires_python": ">=3.8.0",
"size": 6071173,
"upload_time": "2023-12-01T22:22:20",
"upload_time_iso_8601": "2023-12-01T22:22:20.825055Z",
"url": "https://files.pythonhosted.org/packages/fc/8e/143439ae8518f362e5785006fc48834e232ed9601ce58ae8a26b878744d3/redislite-6.2.912183-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "001c6b8eeab46b7e1928f88a1a35613a750221664083566d7150eefc0e751802",
"md5": "a25c34aa5beda3571ac3ee54c8bbd41a",
"sha256": "58617b4d5d57b8f799188178b069a41b64c19e970f733c68cdc92190b417884c"
},
"downloads": -1,
"filename": "redislite-6.2.912183-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "a25c34aa5beda3571ac3ee54c8bbd41a",
"packagetype": "bdist_wheel",
"python_version": "pp310",
"requires_python": ">=3.8.0",
"size": 6070821,
"upload_time": "2023-12-01T22:22:24",
"upload_time_iso_8601": "2023-12-01T22:22:24.758665Z",
"url": "https://files.pythonhosted.org/packages/00/1c/6b8eeab46b7e1928f88a1a35613a750221664083566d7150eefc0e751802/redislite-6.2.912183-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c0e0fc4c3feeaea510dd30141339e2d686312e2e9ccb7ad2997c495b0de268cd",
"md5": "76e05129645318acd5ab8c111c3f5ed6",
"sha256": "4f75bf06cf0adff5fb51fd1364e6a1bef379980489c6b2721a882a7f336c62aa"
},
"downloads": -1,
"filename": "redislite-6.2.912183-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "76e05129645318acd5ab8c111c3f5ed6",
"packagetype": "bdist_wheel",
"python_version": "pp38",
"requires_python": ">=3.8.0",
"size": 6070820,
"upload_time": "2023-12-01T22:22:28",
"upload_time_iso_8601": "2023-12-01T22:22:28.131270Z",
"url": "https://files.pythonhosted.org/packages/c0/e0/fc4c3feeaea510dd30141339e2d686312e2e9ccb7ad2997c495b0de268cd/redislite-6.2.912183-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ac39d759b673d6b01d2936010aaa5bf38f1b91b4e452dc7fab1630223bf7ad98",
"md5": "fc1504e94e8c14408257ac6b994c1400",
"sha256": "157ba9854a42e990ca94583527c454c97f5468ff18f7e48588bc1ed85f175056"
},
"downloads": -1,
"filename": "redislite-6.2.912183-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "fc1504e94e8c14408257ac6b994c1400",
"packagetype": "bdist_wheel",
"python_version": "pp39",
"requires_python": ">=3.8.0",
"size": 6070820,
"upload_time": "2023-12-01T22:22:31",
"upload_time_iso_8601": "2023-12-01T22:22:31.590312Z",
"url": "https://files.pythonhosted.org/packages/ac/39/d759b673d6b01d2936010aaa5bf38f1b91b4e452dc7fab1630223bf7ad98/redislite-6.2.912183-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "af7db6fc82af45ed2aa31f6c8b2035df009ff9fd8be01ad8a691155cc167f1f2",
"md5": "140977b2e0c2388a478776ef61de51da",
"sha256": "40642495cc53bd5ca3cc186355a7235795ef4b36dd167cb77c7e6837d23e5dd6"
},
"downloads": -1,
"filename": "redislite-6.2.912183.tar.gz",
"has_sig": false,
"md5_digest": "140977b2e0c2388a478776ef61de51da",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.0",
"size": 2555087,
"upload_time": "2023-12-01T22:19:28",
"upload_time_iso_8601": "2023-12-01T22:19:28.526453Z",
"url": "https://files.pythonhosted.org/packages/af/7d/b6fc82af45ed2aa31f6c8b2035df009ff9fd8be01ad8a691155cc167f1f2/redislite-6.2.912183.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-01 22:19:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yahoo",
"github_project": "redislite",
"travis_ci": false,
"coveralls": true,
"github_actions": false,
"tox": true,
"lcname": "redislite"
}
JSON
