Skip to content

Latest commit

 

History

History
91 lines (68 loc) · 3.92 KB

README.md

File metadata and controls

91 lines (68 loc) · 3.92 KB
Raw

GLIDE for Redis

General Language Independent Driver for the Enterprise (GLIDE) for Redis, is an AWS-sponsored, open-source Redis client. GLIDE for Redis works with any Redis distribution that adheres to the Redis Serialization Protocol (RESP) specification, including open-source Redis, Amazon ElastiCache for Redis, and Amazon MemoryDB for Redis. Strategic, mission-critical Redis-based applications have requirements for security, optimized performance, minimal downtime, and observability. GLIDE for Redis is designed to provide a client experience that helps meet these objectives. It is sponsored and supported by AWS, and comes pre-configured with best practices learned from over a decade of operating Redis-compatible services used by hundreds of thousands of customers. To help ensure consistency in development and operations, GLIDE for Redis is implemented using a core driver framework, written in Rust, with extensions made available for each supported programming language. This design ensures that updates easily propagate to each language and reduces overall complexity. In this Preview release, GLIDE for Redis is available for Python and Javascript (Node.js), with support for Java actively under development.

Supported Redis Versions

GLIDE for Redis is API-compatible with open source Redis version 6 and 7.

Current Status

We've made GLIDE for Redis an open-source project, and are releasing it in Preview to the community to gather feedback, and actively collaborate on the project roadmap. We welcome questions and contributions from all Redis stakeholders. This preview release is recommended for testing purposes only.

Getting Started - Python Wrapper

System Requirements

The beta release of GLIDE for Redis was tested on Intel x86_64 using Ubuntu 22.04.1, Amazon Linux 2023 (AL2023), and macOS 12.7.

Python supported version

Python 3.8 or higher.

Installation and Setup

Installing via Package Manager (pip)

To install GLIDE for Redis using pip, follow these steps:

  1. Open your terminal.
  2. Execute the command below: 
    $ pip install glide-for-redis
  3. After installation, confirm the client is accessible by running: 
    $ python3
>>> import glide

Basic Examples

Cluster Redis:

>>> import asyncio
>>> from glide import ClusterClientConfiguration, NodeAddress, RedisClusterClient
>>> async def test_cluster_client():
...     addresses = [NodeAddress("redis.example.com", 6379)]
...     config = ClusterClientConfiguration(addresses)
...     client = await RedisClusterClient.create(config)
...     set_result = await client.set("foo", "bar")
...     print(f"Set response is {set_result}")
...     get_result = await client.get("foo")
...     print(f"Get response is {get_result}")
... 
>>> asyncio.run(test_cluster_client())
Set response is OK
Get response is bar

Standalone Redis:

>>> import asyncio
>>> from glide import RedisClientConfiguration, NodeAddress, RedisClient
>>> async def test_standalone_client():
...     addresses = [
...             NodeAddress("redis_primary.example.com", 6379),
...             NodeAddress("redis_replica.example.com", 6379)
...     ]
...     config = RedisClientConfiguration(addresses)
...     client = await RedisClient.create(config)
...     set_result = await client.set("foo", "bar")
...     print(f"Set response is {set_result}")
...     get_result = await client.get("foo")
...     print(f"Get response is {get_result}")
... 
>>> asyncio.run(test_standalone_client())
Set response is OK
Get response is bar

Documentation

Visit our wiki for examples and further details on TLS, Read strategy, Timeouts and various other configurations.

Building & Testing

Development instructions for local building & testing the package are in the DEVELOPER.md file.